CMS API

The CMS API turns any list of structured data on your site into a managed collection. Define a schema once, then create, update, and list items via a single set of endpoints. Every collection is a namespaced bucket scoped to your organization. Items inside a collection are JSON objects validated against the collection’s schema before they are stored.

Why use it

No new tables. Add a sponsors page, a courses catalogue, or a directory in minutes — no migration required.
Validation built-in. Each field has a type (text, image, url, select, date, …). Bad data is rejected at the API boundary.
Public read out of the box. Public collections are cached at the edge for 60 seconds and revalidate automatically when you write.
Monetizable. Pair a collection with a payment_plan whose purpose is cms_item and visitors can pay to add an entry (sponsorships, classifieds, featured listings, …).

Authentication

All CMS endpoints accept an API key via the x-api-key header. Required permission scopes:

Scope	Endpoints
`cms:read`	`GET` endpoints
`cms:write`	`POST`, `PATCH`, `DELETE` endpoints

Wildcard keys (* permission) work for every CMS endpoint.

Get your API key from Dashboard → Settings → API Keys. When creating a key for CMS automation, scope it to cms:read and cms:write only.

Field types

Type	Notes
`text`	Single-line, default max 5,000 chars.
`longtext`	Multi-line, default max 100,000 chars.
`number`	JSON number. Use `min`/`max` for bounds.
`boolean`	`true` / `false`. Strings `"true"`/`"false"` accepted.
`image`	URL or storage path (`/bucket/object.png`).
`url`	Must start with `http://` or `https://`.
`select`	Requires `options: string[]`.
`date`	ISO 8601 timestamp.

Quickstart

# 1. Create a "sponsors" collection
curl -X POST https://api.kardow.com/cms \
  -H "x-api-key: $KARDOW_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "slug": "sponsors",
    "name": "Sponsors",
    "schema": [
      { "name": "name", "type": "text",  "required": true },
      { "name": "logo", "type": "image", "required": true },
      { "name": "url",  "type": "url" }
    ]
  }'

# 2. Add an item
curl -X POST https://api.kardow.com/cms/sponsors \
  -H "x-api-key: $KARDOW_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "data": { "name": "Acme", "logo": "/sponsors/acme.png", "url": "https://acme.com" } }'

# 3. List items
curl https://api.kardow.com/cms/sponsors \
  -H "x-api-key: $KARDOW_API_KEY"

Getting Started

Analytics

Jobs

Applications

Content

Members

Users

Webhooks

CMS

Why use it

Authentication

Field types

Quickstart

​Why use it

​Authentication

​Field types

​Quickstart

Why use it

Authentication

Field types

Quickstart