List Content
Fetch a paginated list of content with filtering, sorting, and search.query GetContents(
$typeId: ID
$tags: [String!]
$locale: String
$search: String
$filter: ContentFilter
$sort: [SortCriteria!]
$cursor: String
$limit: Int
) {
contents(
typeId: $typeId
tags: $tags
locale: $locale
search: $search
filter: $filter
sort: $sort
cursor: $cursor
limit: $limit
) {
data {
id
name
description
tags
locale
updatedAt
}
pagination {
cursor
hasMore
limit
}
}
}
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
typeId | ID | - | Filter by content type |
tags | [String!] | - | Filter by tags (AND logic) |
locale | String | - | Filter by locale |
search | String | - | Search in name and description |
filter | ContentFilter | - | Advanced field filtering |
sort | [SortCriteria!] | - | Sort criteria |
cursor | String | null | Cursor for pagination |
limit | Int | 20 | Items per page |
Filter Example
query {
contents(
typeId: "ct123"
tags: ["tutorial"]
locale: "en-US"
filter: {
createdAt: { gte: "2024-01-01T00:00:00Z" }
}
sort: [{ field: "updatedAt", order: DESC }]
limit: 20
) {
data {
id
name
tags
locale
}
pagination {
cursor
hasMore
}
}
}
{
"data": {
"contents": {
"data": [
{
"id": "cont456",
"name": "Getting Started Guide",
"tags": ["tutorial", "beginner"],
"locale": "en-US"
}
],
"pagination": {
"cursor": "eyJsYXN0SWQiOiJjb250NDU2IiwibGFzdFVwZGF0ZWRBdCI6IjIwMjQtMDEtMTVUMTA6MDA6MDBaIn0=",
"hasMore": false
}
}
}
}
Get Single Content
Fetch a specific content item by ID.query GetContent($id: ID!) {
content(id: $id) {
id
name
description
compiled
tags
locale
contentType {
id
name
schema
}
createdAt
updatedAt
}
}
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | ID! | Yes | Content ID |
Get Content with Resolved Package
Include all package data needed to render the content.query GetContentResolved($id: ID!) {
content(id: $id) {
id
name
compiled
contentType {
name
schema
}
resolvedPackage {
package {
id
version
components
assets
}
dependencies {
id
version
components
assets
}
}
}
}
Get Content with Caching References
For optimal caching, fetch only package IDs and resolve separately.query GetContentWithCaching($id: ID!) {
content(id: $id) {
id
name
compiled
resolvedRef {
package
dependencies
}
}
}
{
"data": {
"content": {
"id": "cont123",
"name": "Getting Started",
"compiled": "const body = () => { ... }",
"resolvedRef": {
"package": "abc123def456...",
"dependencies": ["xyz789ghi012..."]
}
}
}
}
Content Fields
| Field | Type | Description |
|---|---|---|
id | ID! | Unique identifier |
typeId | ID! | Content type ID |
packageVersion | String! | Package version |
name | String! | Content name |
description | String! | Content description |
content | String! | Content data |
compiled | String! | Compiled content data |
tags | [String!]! | Associated tags |
locale | String | Content locale |
lastPublishedVersion | Int | Last published version number |
cdnUrl | String | CDN URL for the content |
contentType | ContentType | Associated content type |
resolvedPackage | ResolvedPackage | Full package data |
resolvedRef | ResolvedPackageRef! | Package IDs for caching |
createdAt | DateTime! | Creation timestamp |
updatedAt | DateTime! | Last update timestamp |