List your posts
Returns posts newest first by default, with the post-level fields only. Per-account delivery state lives on GET /posts/{postId}. Note that from and to filter on creation time, not on the scheduled publish time. Sorting by scheduledFor silently excludes posts that have no scheduled time, since unscheduled drafts have nothing to sort on. Cursor-paginated.
Request
- Base URL: https://www.juzpost.com/api/cli/v1
- URL: https://www.juzpost.com/api/cli/v1/posts
- Auth: HTTP bearer
Query parameters
How many items to return in this page. Values outside 1-100 are clamped rather than rejected. Defaults to 20.
Opaque continuation token. Omit it for the first page, then pass back the previous response's pagination.nextCursor verbatim. Never parse, construct or modify it, and do not reuse a cursor after changing sort, order or any filter, which returns 400 with error.details.code of invalid_cursor.
Sort direction. Anything other than the literal asc is treated as desc.
Which field to sort posts by. Choosing scheduledFor restricts the result to posts that actually have a scheduled time; unscheduled drafts are omitted. An unlisted value returns 400.
Return only posts in this status, matched exactly, typically draft, scheduled, posted or failed.
Return only posts that target this social account. An account with no posts yields an empty page rather than an error.
Return only posts created at or after this instant. This filters on creation time, not on the scheduled publish time. Any string parseable as a date is accepted; send ISO 8601.
Return only posts created at or before this instant. Filters on creation time, not on the scheduled publish time.
Response
One page of posts.
Changes
No recorded changes to this operation across all 1 revision of this API.