Upsert a content item
PUT https://manage.kontent.ai/v2/projects/:environment_id/items/:item_identifier
Update or create a content item.
- To update a content item, you need to identify the existing item by its internal ID, external ID, or codename.
- To create a content item, you need to specify the external ID as the item's identifier. You can also specify external ID when adding content items.
Content items don't contain any content themselves directly. They serve as wrappers for language variants. Language variants hold the items' content even in environments with a single language.
To change the content in content items, upsert their specific language variant.
Request Body
{"name"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "codename"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "collection"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "sitemap_locations"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"id":"335d17ac-b6ba-4c6a-ae31-23c1193215cb","name":"My new article","codename":"my_article","type":{"id":"b7aa4a53-d9b1-48cf-b7a6-ed0b182c4b89"},"collection":{"id":"00000000-0000-0000-0000-000000000000"},"spaces":[{"id":"dcbf90fb-7135-4465-8102-b3e739821ed8"},{"id":"39efe8a4-23d2-4d3a-8dfb-07789668474f"}],"sitemap_locations":[],"external_id":"custom-identifier-for-my-article","last_modified":"2020-04-04T13:45:30.7692802Z"}