CMSItems

Create Collection Item

Create a new collection item. To upload a new image to an attachment field, set the field value to the image URL. To reuse an existing image from a collection, set the field value to the fileId property.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

collection_idstringRequiredformat: "uuid"
Unique identifier for a Collection

Headers

Accept-VersionstringOptional
The API version

Query parameters

livebooleanOptional

Boolean indicating if the item(s) should be published/unpublished to/from the live site

Request

The collection item to create
fieldsobjectOptional
The fields for the new item

Response

Request was successful
_archivedboolean or nullDefaults to false
Boolean determining if the Item is set to archived
_draftboolean or nullDefaults to false
Boolean determining if the Item is set to draft
_idstring or nullRead-only
Unique identifier for the Item
_cidstring or nullRead-only
Unique identifier for the Collection the Item belongs within
namestring or null
Name given to the Item
slugstring or null

URL structure of the Item in your site. Note: Updates to an item slug will break all links referencing the old slug.

Errors