List Content Types
Fetch a paginated list of content types with optional search.query GetContentTypes($search: String, $cursor: String, $limit: Int) {
contentTypes(search: $search, cursor: $cursor, limit: $limit) {
data {
id
name
description
packageVersion
}
pagination {
cursor
hasMore
limit
}
}
}
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
search | String | - | Filter by name |
cursor | String | null | Cursor for pagination |
limit | Int | 20 | Items per page |
Example
query {
contentTypes(search: "Article", limit: 10) {
data {
id
name
description
packageVersion
}
pagination {
cursor
hasMore
}
}
}
{
"data": {
"contentTypes": {
"data": [
{
"id": "ct123",
"name": "Article",
"description": "Blog articles and news posts",
"packageVersion": "2.0.0"
},
{
"id": "ct124",
"name": "ArticleSummary",
"description": "Compact article display",
"packageVersion": "2.0.0"
}
],
"pagination": {
"cursor": null,
"hasMore": false
}
}
}
}
Get Single Content Type
Fetch a specific content type by ID.query GetContentType($id: ID!) {
contentType(id: $id) {
id
name
description
packageVersion
schema
createdAt
updatedAt
}
}
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | ID! | Yes | Content type ID |
Example
query {
contentType(id: "ct123") {
id
name
description
packageVersion
schema
}
}
{
"data": {
"contentType": {
"id": "ct123",
"name": "Article",
"description": "Blog articles and news posts",
"packageVersion": "2.0.0",
"schema": "{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\"},\"body\":{\"type\":\"string\"},\"author\":{\"type\":\"string\"}}}"
}
}
}
Content Type Fields
| Field | Type | Description |
|---|---|---|
id | ID! | Unique identifier |
name | String! | Content type name |
description | String! | Description |
packageVersion | String! | Bound package version |
schema | String! | JSON Schema defining content structure |
createdAt | DateTime! | Creation timestamp |
updatedAt | DateTime! | Last update timestamp |
Schema Structure
Theschema field contains a JSON Schema that defines the content structure:
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Article title"
},
"body": {
"type": "string",
"description": "Article body content"
},
"author": {
"type": "string",
"description": "Author name"
},
"publishDate": {
"type": "string",
"format": "date-time"
},
"tags": {
"type": "array",
"items": { "type": "string" }
}
},
"required": ["title", "body"]
}