API ReferencePosts
List posts
Cursor-paginated, newest first. Filter with ?status= and ?channelId=.
Authorization
api-key AuthorizationBearer <token>
Workspace API key (nim_live_...)
In: header
Query Parameters
status?string
Filter by status
Value in
- "DRAFT"
- "PENDING_APPROVAL"
- "SCHEDULED"
- "PUBLISHED"
- "FAILED"
- "ARCHIVED"
channelId?string
Filter by channel id
limit?number
Page size (1–100, default 25)
Default
25cursor?string
Cursor from the previous page (nextCursor)
Response Body
application/json
curl -X GET "https://example.com/v1/posts"{ "data": [ { "id": "123e4567-e89b-12d3-a456-426614174000", "channelId": "123e4567-e89b-12d3-a456-426614174000", "content": "Launching something new today 🚀", "title": null, "contentType": "POST", "status": "SCHEDULED", "scheduledAt": "2026-08-01T09:00:00.000Z", "publishedAt": null, "createdAt": "2026-07-05T10:00:00.000Z", "mediaIds": [ "string" ] } ], "nextCursor": "123e4567-e89b-12d3-a456-426614174000"}