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.

Path parameters

collection_idstringRequiredformat: "uuid"
Unique identifier for a Collection

Headers

AuthorizationstringRequired

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

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 null
Unique identifier for the Item
_cidstring or null
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