Content Management API

Timeline assets

Currently supported actions:

  • Query release asset versions
  • Fetch release asset version
  • Update release asset version

Assets collection

Get all assets of a release

To fetch specific assets use query search parameters.

Create an asset

Use this endpoint to create a new asset and add it to the release in one step.

When using this endpoint, an ID will be automatically generated for the created asset and returned with the response.

Asset

Update an asset

Use this endpoint to create a new asset with a specified ID, or update an existing asset with its ID.

When updating an existing asset, you need to specify the last version you have of the asset with X-Contentful-Version.

Get an asset

Asset processing

To publish an asset, or to preview it within the Contentful web app (under the “Media” tab), you need to process it before. This step is fetching the image from the given location to Contentful’s system. This request might return before the asset processing is finished. The asset will have a fields.file.url for the respective locale if processing completed successfully.

Due to security considerations we forbid users to upload and process files with mime type text/html or text/javascript.

If you want to store HTML files in Contentful, please use application/octet-stream as the contentType. Keep in mind that these files will not be rendered by browsers by default.

Process an asset