Understanding Asset URL

When you upload an asset to Contentstack, a public URL is automatically generated for that asset. This URL follows a predefined structure:

https://{base_url}/v3/assets/{stack_api_key}/{asset_uid}/{file_uid}/filename

Here's the breakdown of the asset URL:

• base_url: Indicates the domain used for your asset. Assets can have either of these base URLs:
  • assets.contentstack.io: Used for generic assets.
  • images.contentstack.io: Used for image files specifically.
• stack_api_key: The API key of your stack.
• asset_uid: A unique identifier for the asset itself. This remains constant even if the asset is updated or replaced.
• file_uid: This identifies the specific file instance of the asset. If you replace the asset, the asset_uid stays the same, but the file_id changes. This reflects that the underlying file has changed.
• filename: The name of the file, as uploaded.

Additional Resource: For assets that are updated frequently, you can generate a permanent URL, which remains constant even when new versions of the asset are uploaded. This ensures consistent references to the asset.