Skip to content

List content items

GET
/v1/brands/{brandId}/content/items
curl --request GET \
--url https://kynectlocal-production.up.railway.app/v1/v1/brands/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/content/items \
--header 'Authorization: Bearer <token>'
brandId
required
string format: uuid

Brand identifier

Success

Media type application/json
object
data
required
object
items
required
Array<object>
object
id
required

Content item identifier

string format: uuid
brandId
required

Parent brand

string format: uuid
tenantId
required

Parent tenant

string format: uuid
type
required

Content type: PAGE | SNIPPET | SECTION

string
slug
required

URL-safe slug

string
title
required

Page/content title

string | null
status
required

Publication status: draft | published | scheduled

string
publishedAt
required

Publication timestamp

string | null format: date-time
scheduledFor
required

Scheduled publication timestamp

string | null format: date-time
blocks_version
required

Puck blocks schema version

integer
activeTemplateId
required

Active template identifier

string | null format: uuid
activeTemplateName
required

Active template display name

string | null
createdAt
required

Creation timestamp

string format: date-time
updatedAt
required

Last update timestamp

string format: date-time
nextCursor
required

Cursor for next page; null when no more results

string | null
Example generated
{
"data": {
"items": [
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"brandId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"tenantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"type": "example",
"slug": "example",
"title": "example",
"status": "example",
"publishedAt": "2026-04-15T12:00:00Z",
"scheduledFor": "2026-04-15T12:00:00Z",
"blocks_version": 1,
"activeTemplateId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"activeTemplateName": "example",
"createdAt": "2026-04-15T12:00:00Z",
"updatedAt": "2026-04-15T12:00:00Z"
}
],
"nextCursor": "example"
}
}

Validation error

Media type application/json
object
error
required

Error envelope

object
code
required

Machine-readable error code

string
message
required

Human-readable error description

string
details

Additional context, e.g. validation field errors

Example generated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Unauthenticated

Media type application/json
object
error
required

Error envelope

object
code
required

Machine-readable error code

string
message
required

Human-readable error description

string
details

Additional context, e.g. validation field errors

Example generated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Forbidden

Media type application/json
object
error
required

Error envelope

object
code
required

Machine-readable error code

string
message
required

Human-readable error description

string
details

Additional context, e.g. validation field errors

Example generated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Not found

Media type application/json
object
error
required

Error envelope

object
code
required

Machine-readable error code

string
message
required

Human-readable error description

string
details

Additional context, e.g. validation field errors

Example generated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Unprocessable

Media type application/json
object
error
required

Error envelope

object
code
required

Machine-readable error code

string
message
required

Human-readable error description

string
details

Additional context, e.g. validation field errors

Example generated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}