Skip to main content
GET
List Content Items

Authorizations

x-api-key
string
header
required

API key for authentication. You can create one here.

Query Parameters

website_id
string<uuid>
required

The website whose Content Hub to enumerate.

sheet_id
string<uuid>

Restrict to a single Content Hub tab. Use GET /api/v1/content/sheets to discover IDs. A view-type tab resolves to the shared main pool. Omit to span every tab.

content_type
enum<string>

Restrict to a single content type. athena_created is a shortcut for the four Athena-generated subtypes (draft, snipe, optimize, slice). Omit to span every type.

Available options:
external,
imported,
athena_created,
draft,
snipe,
optimize,
slice,
manual
stage
enum<string>

Restrict to a single pipeline stage. Matches the pipeline record only, so it can never match rows without one (most external and imported pages). Omit to span every stage.

Available options:
scheduled,
pending,
pending_brief,
generated_brief,
pending_article,
generated,
done,
failed
prompt_id
string<uuid>

Restrict to items written for this prompt (their targeting, the same prompt ids POST /api/v1/content/generate takes). Soft-deleted prompts still match.

page_num
integer
default:0

Zero-indexed page number.

Required range: x >= 0
page_size
integer
default:50

Number of items per page (1-100).

Required range: 1 <= x <= 100

Response

Successful response with the page of content items.

content
object[]
required
pagination
object
required

Pagination metadata. Uses page_size + 1 lookahead — has_more=true means the next page is non-empty. No total-count field, by design (avoids the extra COUNT(*) round-trip).