Get an asset
GET https://{{base_url}}/v3/assets/{{asset_uid}}
The Get an asset request returns comprehensive information about a specific version of an asset of a stack.
To use the API Request, you will need to authenticate yourself either with a Management Token (highly recommended) or an Authtoken.
Read more about it in Authentication.
For more information, refer to the Get an asset API Reference document
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
include_path | boolean | Set this parameter to ‘true’ to retrieve the complete path of the folder. The path will be displayed as an array of objects which includes the names and UIDs of each parent folder. | |
version | number | Specify the version number of the asset that you want to retrieve. If the version is not specified, the details of the latest version will be retrieved. | |
Note: If no version is mentioned, this request will retrieve the latest published version of the asset. To retrieve a specific version, make use of the version parameter and keep the environment parameter blank. | |||
environment | string | Enter the name of the environment to retrieve assets published on them. You can enter multiple environments. | |
include_publish_details | boolean | Enter 'true' to include the publish details of the asset. | |
relative_urls | boolean | Set this to 'true' to display the relative URL of the asset. This parameter is not applicable when you delete an asset. | |
include_branch | boolean | Set this to 'true' to include the '_branch' top-level key in the response. This key states the unique ID of the branch where the concerned Contentstack module resides. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
api_key | string | Enter the API key of the stack that holds the asset | |
authtoken | string | ||
authorization | string | For this call we recommend you to use management token. | |
Content-Type | string | ||
branch | string | Enter your branch unique ID. |