API changelog

Table of contents

    Changes to URL slug element model

    Planned for October 30, 2019

    The URL slug element in language variants lets you specify the element's mode via the new mode property. With the mode property, you can programmatically choose whether the URL slug element's value is generated automatically or assigned manually.

    Update to sign-in URL

    October 14, 2019

    The domain used when signing in to Kentico Kontent has been changed to https://login.kontent.ai. Users will be redirected to this domain automatically when accessing https://app.kontent.ai without being signed in.

    Asset folders added to Content Management API

    October 2, 2019

    Added support for managing asset folders via Content Management API v2 using the /folders endpoint with GET, POST, or PUT operations. Use GET /folders to retrieve a list of your folders, POST /folders for initial creation of the folder structure, and PUT /folders for performing operations (adding "op":"addInto", renaming "op":"rename", removing "op":"remove") over your existing folder structure.

    Asset model change in Content Management API

    October 2, 2019

    The asset objects retrieved via Content Management API v1 and v2 now contain a new url property with a URL to the binary file.

    Changes to paging in Content Management API v2

    September 25, 2019

    The continuationToken query parameter has been deprecated and replaced with the x-continuation request header. The change affects endpoints that return a dynamically paginated list of objects. The original query parameter will continue to work until the API transitions out of beta.

    SDK packages renamed

    September 25, 2019

    In relation to the recent rebranding to Kentico Kontent, SDK packages are being updated according to the new naming.

    New SDK packages:

    New boilerplate packages:

    New sample apps:

    Packages for Java, Swift, Android, and Gatsby and developer tools (such as code generators) will follow shortly.

    Please note that the packages contain new endpoint URLs (https://*.kontent.ai) and the namespaces have been updated accordingly to Kentico.Kontent.*.

    API URLs changed

    September 16, 2019

    The API URLs are now changed to:

    • https://deliver.kontent.ai/ for the Delivery API
    • https://preview-deliver.kontent.ai/ for the Preview Delivery API
    • https://manage.kontent.ai/v2/ for the Content Management API v2 (BETA)
    • https://manage.kontent.ai/v1/ for the Content Management API v1
    • https://recommendations.kontent.ai/ for the Recommendation API (BETA)

    The original URLs containing kenticocloud.com will still be functional until the end of March 2020. After that, the old URLs will be automatically redirected to the new ones.

    Note that the redirect might not work for custom Kentico Kontent implementations that don't use SDKs or apply blocking rules at the sub-domain level.

    Changes to content item PUT requests

    September 16, 2019

    The sitemap_locations property has been made optional for the body of the content item upsert requests for Content Management API version 1 and version 2.

    Changes to references in taxonomy and language updates

    September 16, 2019

    The way PATCH operations to modify taxonomy groups and languages work with references has been changed.

    For the Modify a language endpoint, the reference body parameter has been removed. The operation will be applied to the language specified in the language_identifier path parameter.

    For the Modify taxonomy groups endpoint, the reference body parameter is optional for the replace and addInto operations. If a reference is not specified, the operation will apply to the taxonomy group specified in the taxonomy_group_identifier path parameter. If a reference is specified, the operation will apply to the specified term. The reference body parameter is still required for the remove operation.

    Webhook triggers extended

    July 24, 2019

    The types and operations for webhooks were extended to newly include change_workflow_status as webhooks can be triggered on changes to the workflow step an item is in.

    Element limitations in Content Management API

    July 24, 2019

    Version 2 of the Content Management API now includes limitations for elements in content types. The API now returns information about limitations in content type responses (all kinds of requests). See example responses in the content type model.

    Webhook notification model change

    July 18, 2019

    The webhook notification model was extended with the id property for content items and taxonomy groups. With the ID in the notifications, you can uniquely identify any items or taxonomy groups that were modified, even if they were renamed and their codenames changed.

    • JSON
    { "data": { "items": [ { "id": "e5d575fe-9608-4523-a07d-e32d780bf92a", "codename": "where_does_coffee_come_from_", "language": "en-US", "type": "article" } ], "taxonomies": [ { "id": "4794dde6-f700-4a5d-b0dc-9ae16dcfc73d", "codename": "personas" } ] }, "message": { "id": "e1b372a2-1186-4929-b370-904c59f060b7", "project_id": "bf32e7ab-85c3-0073-47b9-90838a8462de", "type": "taxonomy", "operation": "upsert", "api_name": "delivery_production", "created_timestamp": "2019-07-18T10:52:33.1059256Z", "webhook_url": "https://myapp.com/webhook-endpoint" } }
    { "data": { "items": [ { "id": "e5d575fe-9608-4523-a07d-e32d780bf92a", "codename": "where_does_coffee_come_from_", "language": "en-US", "type": "article" } ], "taxonomies": [ { "id": "4794dde6-f700-4a5d-b0dc-9ae16dcfc73d", "codename": "personas" } ] }, "message": { "id": "e1b372a2-1186-4929-b370-904c59f060b7", "project_id": "bf32e7ab-85c3-0073-47b9-90838a8462de", "type": "taxonomy", "operation": "upsert", "api_name": "delivery_production", "created_timestamp": "2019-07-18T10:52:33.1059256Z", "webhook_url": "https://myapp.com/webhook-endpoint" } }

    Title for web links

    June 26, 2019

    You can now specify titles for web URL links in Rich text elements to improve SEO of your website. When you specify a link title in the UI,  the title will be rendered in the API responses from the Delivery API and Content Management API v2.

    • JSON
    # Delivery API "content": { "type": "rich_text", "name": "Content", "images": {}, "links": {}, "modular_content": [], "value": "<p><a href=\"http://www.kenticocloud.com\" title=\"#1 CMS\">Kentico Cloud</a></p>" } # Content Management API v2 { "element": { "id": "0ddd5a94-0360-5126-92e6-264dfbb61849" }, "value": "<p><a href=\"http://www.kenticocloud.com\" title=\"#1 CMS\">Kentico Cloud</a></p>" }
    # Delivery API "content": { "type": "rich_text", "name": "Content", "images": {}, "links": {}, "modular_content": [], "value": "<p><a href=\"http://www.kenticocloud.com\" title=\"#1 CMS\">Kentico Cloud</a></p>" } # Content Management API v2 { "element": { "id": "0ddd5a94-0360-5126-92e6-264dfbb61849" }, "value": "<p><a href=\"http://www.kenticocloud.com\" title=\"#1 CMS\">Kentico Cloud</a></p>" }

    Image resolution in Delivery API

    April 24, 2019

    Extended the asset model with the width and height properties. This applies to assets used in the Asset and Rich text elements. With this enhancement, you can, for example, render placeholders for images in your application before the assets themselves are loaded.

    • JSON
    "teaser_image": { "type": "asset", "name": "Teaser image", "value": [ { "name": "coffee-beverages-explained-1080px.jpg", "type": "image/jpeg", "size": "90895", "description": null, "url": "https://assets-us-01.kc-usercontent.com/38af179c-40ba-42e7-a5ca-33b8cdcc0d45/e700596b-03b0-4cee-ac5c-9212762c027a/coffee-beverages-explained-1080px.jpg", "width": 1000, "height": 666 } ] }
    "teaser_image": { "type": "asset", "name": "Teaser image", "value": [ { "name": "coffee-beverages-explained-1080px.jpg", "type": "image/jpeg", "size": "90895", "description": null, "url": "https://assets-us-01.kc-usercontent.com/38af179c-40ba-42e7-a5ca-33b8cdcc0d45/e700596b-03b0-4cee-ac5c-9212762c027a/coffee-beverages-explained-1080px.jpg", "width": 1000, "height": 666 } ] }

    Content models in Content Management API

    April 18, 2019

    Added support for managing content types, content type snippets, and taxonomy groups in Content Management API v2. You can use the new endpoints to import content models from other systems, integrate with third party services, or synchronize changes across multiple projects (Continuous Integration).

    Workflow steps in Content Management API

    Feb 7, 2019

    Added endpoints that let you programmatically create new versions of your content as well as publish, schedule publishing, or unpublish your content. This is especially useful for automating your work or enriching your content with data from other sources. Learn more about Workflow in Content Management API v2.