Skip to main content
POST
Create an item

Authorizations

Authorization
string
header
required

Cactal API key. Create one in the dashboard or via POST /apiKeys. The plaintext key is shown once at creation.

Path Parameters

collectionId
string
required
Minimum string length: 1

Body

application/json
slug
string
Pattern: ^[a-z0-9][a-z0-9-]{0,255}$
publishedAt
any | null

Initial publication timestamp. Must not be in the future. Omit for a draft, or use publishAt to schedule publication.

publishAt
any | null

Future absolute timestamp for scheduled publication. Cannot be combined with publishedAt.

data
object
references
object
images
object
files
object

Response

Identity of the created item. Read the full item back with the get-item endpoint.

id
string
required

Id of the created item.

slug
string
required

Slug of the created item, derived from data.title or data.name when not provided.

publishedAt
string<date-time> | null
required

null when the item was created as a draft; the publish timestamp otherwise.

publishAt
string<date-time> | null
required

Future publication time when the item was created as scheduled; null otherwise.