Skip to main content
POST
/
cms
/
{slug}
Create CMS Item
curl --request POST \
  --url https://api.kardow.com/cms/{slug} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "data": {},
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "published",
  "starts_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "owner_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "item": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "data": {},
    "status": "<string>",
    "starts_at": "2023-11-07T05:31:56Z",
    "expires_at": "2023-11-07T05:31:56Z",
    "position": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://kardow.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

The data object is validated against the collection’s schema before the row is stored. Required fields must be present; unknown fields are dropped.

​
Example

curl -X POST https://api.kardow.com/cms/sponsors \
  -H "x-api-key: $KARDOW_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "data": {
      "name": "Globex",
      "logo": "https://cdn.example.com/globex.png",
      "url": "https://globex.com"
    },
    "status": "published"
  }'
Pass expires_at to make the item disappear from public lists after a specific moment, or starts_at to schedule it.

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get yours from Settings > API Keys in the Kardow dashboard.

Path Parameters

​
slug
string
required

Body

application/json
​
data
object
required

Validated against the collection's schema.

​
id
string<uuid>

Provide to update an existing item.

​
status
enum<string>
default:published
Available options:
draft,
pending_review,
published,
expired,
archived
​
starts_at
string<date-time> | null
​
expires_at
string<date-time> | null
​
owner_user_id
string<uuid> | null

Response

Created

​
item
object