Sign in

v3

latestOpenAPI 3.1.02026-08-016689273.4 KB
Posts

List posts

List all posts in the workspace with pagination and filtering. Archived posts are excluded from results.

get/posts

Query parameters

limitinteger

Maximum number of posts to return (1-100)

cursorstring uuid

Cursor for pagination (post ID from the last item of previous page)

string uuid
OR
string[]

Fetch specific posts by IDs. Can be a single UUID or comma-separated list.

status'Tentative' | 'ToDo' | 'InProgress' | 'ForReview' | 'Blocked' | 'Finalized' | 'Scheduled' | 'Posted'

Filter by post status

channel'LinkedIn' | 'Twitter' | 'Instagram' | 'TikTok' | 'YouTubeShorts'

Filter by channel

linkedInProfileIdstring uuid

Filter by LinkedIn profile ID

xProfileIdstring uuid

Filter by X/Twitter profile ID

instagramProfileIdstring uuid

Filter by Instagram profile ID

tikTokProfileIdstring uuid

Filter by TikTok profile ID

youTubeProfileIdstring uuid

Filter by YouTube channel profile ID

string uuid
OR
string[]

Filter by label IDs (posts with any of these labels). Can be a single UUID or comma-separated list.

publishDateMinstring date-time

Filter posts scheduled on or after this date (ISO 8601 format)

publishDateMaxstring date-time

Filter posts scheduled on or before this date (ISO 8601 format)

createdAtMinstring date-time

Filter posts created on or after this date (ISO 8601 format)

createdAtMaxstring date-time

Filter posts created on or before this date (ISO 8601 format)

sortBy'createdAt' | 'publishAt'

Field to sort by

sortOrder'asc' | 'desc'

Sort order

Response

List of posts

nextCursorstring nullable

Cursor for the next page of results

hasMoreboolean

Whether there are more results