Content

Content list view in the Studio module — The Content page.

GET /api/v1/content

List all content items for the tenant. Supports cursor-based pagination and filtering.

Query Parameters

Parameter	Type	Default	Description
`limit`	integer	`20`	Max results per page
`cursor`	string	—	Cursor for pagination
`status`	string	—	Filter by status (e.g., `"draft"`, `"published"`)
`channelType`	string	—	Filter by channel type
`isTemplate`	string	—	Filter templates (`"true"` or `"false"`)
`sourceType`	string	—	Filter by source type

Response

{
  "data": [
    {
      "id": "content_001",
      "name": "Spring Promotion Email",
      "tenantId": "tenant_001",
      "channelType": "email",
      "status": "published",
      "version": 4,
      "content": { "subject": "Spring deals just for you", "body": "<html>...</html>" },
      "blocks": [],
      "personalization": { "customer_name": "{{customer.name}}" },
      "isTemplate": false,
      "sourceType": "internal",
      "parentTemplate": { "id": "tmpl_001", "name": "Seasonal Template" },
      "source": null,
      "createdAt": "2026-03-01T10:00:00.000Z",
      "updatedAt": "2026-03-10T12:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 15,
    "hasMore": false,
    "limit": 20,
    "cursor": null
  }
}

POST /api/v1/content

Create a new content item. The item starts in "draft" status at version 1. An initial version snapshot is created automatically.

Request Body

Field	Type	Required	Description
`name`	string	Yes	Content item name (must be unique per tenant)
`channelType`	string	Yes	Channel type (e.g., `"email"`, `"sms"`, `"push"`)
`description`	string	No	Description
`content`	object	No	Content payload (e.g., subject, body, etc.)
`blocks`	array	No	Content blocks for block-based editing
`personalization`	object	No	Personalization configuration
`parentTemplateId`	string	No	ID of a template to inherit from
`isTemplate`	boolean	No	Whether this item is a reusable template. Default: `false`

Example

curl -X POST https://playground.kaireonai.com/api/v1/content \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "name": "Welcome Email",
    "channelType": "email",
    "content": {
      "subject": "Welcome to Kaireon!",
      "body": "<html>...</html>"
    },
    "personalization": {
      "customer_name": "{{customer.name}}"
    }
  }'

Error Codes

Code	Reason
`201`	Content item created successfully
`409`	A content item with that name already exists

Response: 201 Created with the content item object.

GET /api/v1/content/

Get a content item with its parent template, source, and recent version history (up to 20 versions).

Response

{
  "id": "content_001",
  "name": "Spring Promotion Email",
  "status": "published",
  "version": 4,
  "content": { "subject": "Spring deals just for you", "body": "<html>...</html>" },
  "blocks": [],
  "personalization": { "customer_name": "{{customer.name}}" },
  "parentTemplate": { "id": "tmpl_001", "name": "Seasonal Template" },
  "source": null,
  "publishedAt": "2026-03-10T12:00:00.000Z",
  "versions": [
    { "id": "cv_004", "version": 4, "createdAt": "2026-03-10T12:00:00.000Z" }
  ]
}

PUT /api/v1/content/

Update a content item. Increments the version number and creates a version snapshot automatically.

Request Body

Field	Type	Required	Description
`name`	string	No	Updated name
`content`	object	No	Updated content payload
`blocks`	array	No	Updated content blocks
`personalization`	object	No	Updated personalization config

Response: 200 OK

DELETE /api/v1/content/

Archive a content item (soft delete — sets status to "archived"). Response: 204 No Content

POST /api/v1/content//submit

Submit a draft content item for review. Changes status from "draft" to "in_review". Prerequisite: Content must be in "draft" status. Response: 200 OK

POST /api/v1/content//approve

Approve a content item that is in review. Changes status from "in_review" to "approved". Prerequisite: Content must be in "in_review" status. The approver cannot be the same user who submitted the content (self-approval prevention). Response: 200 OK

POST /api/v1/content//publish

Publish an approved content item. Sets status to "published" and records publishedAt. Creates a version snapshot. Prerequisite: Content must be in "approved" status. Response: 200 OK

POST /api/v1/content//reject

Reject a content item in review. Returns it to "draft" status. Prerequisite: Content must be in "in_review" status.

Request Body

Field	Type	Required	Description
`reason`	string	No	Rejection reason

Response: 200 OK

GET /api/v1/content//versions

List all version snapshots for a content item (up to 100, newest first).

Response

[
  {
    "id": "cv_004",
    "contentItemId": "content_001",
    "version": 4,
    "content": { "subject": "Spring deals just for you" },
    "changeNote": "Published",
    "changedBy": "user_001",
    "createdAt": "2026-03-10T12:00:00.000Z"
  }
]

POST /api/v1/content//revert/

Revert a content item to a previous version. Creates a new version with the snapshot’s content and resets status to "draft". Prerequisite: Target version must be less than the current version.

Example

curl -X POST https://playground.kaireonai.com/api/v1/content/content_001/revert/2 \
  -H "X-Tenant-Id: my-tenant"

Response: 200 OK with the updated content item at the new version number.

Content Lifecycle

draft --> in_review --> approved --> published
  ^          |
  |          v
  +------ rejected (returns to draft)
  ^
  |
  +------ reverted (returns to draft)

Roles

Endpoint	Allowed Roles
`GET /content`	admin, editor, viewer
`POST /content`	admin, editor
`GET /content/{id}`	admin, editor, viewer
`PUT /content/{id}`	admin, editor
`DELETE /content/{id}`	admin, editor
`POST /content/{id}/submit`	admin, editor
`POST /content/{id}/approve`	admin, editor
`POST /content/{id}/publish`	admin, editor
`POST /content/{id}/reject`	admin, editor
`GET /content/{id}/versions`	admin, editor, viewer
`POST /content/{id}/revert/{version}`	admin, editor

Overview

Decisioning

Studio

Data

Algorithms & Models

Content & Metrics

Orchestration

Customers & Traces

Events & Attribution

Analytics

AI

Testing & Simulation

Export & Import

Admin

Integrations

GET /api/v1/content

Query Parameters

Response

POST /api/v1/content

Request Body

Example

Error Codes

GET /api/v1/content/

Response

PUT /api/v1/content/

Request Body

DELETE /api/v1/content/

POST /api/v1/content//submit

POST /api/v1/content//approve

POST /api/v1/content//publish

POST /api/v1/content//reject

Request Body

GET /api/v1/content//versions

Response

POST /api/v1/content//revert/

Example

Content Lifecycle

Roles

​GET /api/v1/content

​Query Parameters

​Response

​POST /api/v1/content

​Request Body

​Example

​Error Codes

​GET /api/v1/content/

​Response

​PUT /api/v1/content/

​Request Body

​DELETE /api/v1/content/

​POST /api/v1/content//submit

​POST /api/v1/content//approve

​POST /api/v1/content//publish

​POST /api/v1/content//reject

​Request Body

​GET /api/v1/content//versions

​Response

​POST /api/v1/content//revert/

​Example

​Content Lifecycle

​Roles

GET /api/v1/content

Query Parameters

Response

POST /api/v1/content

Request Body

Example

Error Codes

GET /api/v1/content/

Response

PUT /api/v1/content/

Request Body

DELETE /api/v1/content/

POST /api/v1/content//submit

POST /api/v1/content//approve

POST /api/v1/content//publish

POST /api/v1/content//reject

Request Body

GET /api/v1/content//versions

Response

POST /api/v1/content//revert/

Example

Content Lifecycle

Roles