API Change Log

To keep our platform up to date, we may occasionally add new resources, new fields, new response keys to the Contentstack APIs, or change the existing resources. All such changes and upgrades are documented here.

July 29, 2019

The Reference field has been upgraded to include references to more than one content types.

The input format of your Reference field has been changed from an array of strings to an array of objects. The change in the Reference field format is as follows:

OLDNEW
{
    ...
    "ref_field": ["entry_UID1", entry_UID2, ...]
    ...
}
{
    ...
    "ref_field": [{
            "uid": "entry_UID",
            "_content_type_uid": "referred_content_type"
        }, {}, ...
        ...
    ]
}

Read more

March 08, 2019

The webhook data of an entry or asset that is published or unpublished via release deployment now includes a source key that contains the (type, title, and uid) of the source (i.e., release). Here's an example of the key that is added to the webhook data:

"source": {
    "type": "release",
    "title": "{{release_title}}",
    "uid": "{{release_uid}}"
},

Read more

Oct 14, 2017

  • The URL of assets for stacks created after this release will include the file name, and the URL pattern will be /v3/assets/:api_key/:asset_uid/:token/:filename. To enforce the changes on images of existing RTE or Markdown fields, you need to re-upload the images and then re-publish the entry for the changes to reflect. For more information, contact us.
  • It will now be possible to get entries by URL even if the entries use default URL pattern. This change will be applicable only to the stacks created after this release.
  • Entries that have empty URL after the upgrade, the user will have to re-save the entry to get them autopolulated in the URL field.

Read more

June 24, 2017

  • The publish_details key that was available in the response of GET requests of draft entries and assets will be no longer returned by default. To include it in the response, use the include_publish_details parameter.
  • The publish_details key available in the response of GET requests of entries and assets of specific environment(s) will now contain the details of only the environment(s) specified in the environment parameter, and not of all the environments.
  • The image URL, when opened in the browser will render the image, instead of downloading it.
  • Any API request will return a maximum of 100 records (changed from 1000 earlier). The next batch of records can be retrieved by making the same request and changing the skip parameter to 100 from 0.

Read more

Oct 30, 2016

  • With the introduction of the new V3 APIs, there is a change in response of several API requests. These are breaking changes, and may require you to adjust your code. Click the 'Read more' link below to see what changed. 

Read more

top-arrow