Drafts

List drafts

Lists your Drafts and, with status=published, publish records (account, post id, time; never Drafts). Filter by status, account (or none) and a [from, to) range on each item's own date.

get/v1/drafts

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/drafts
  • Auth: HTTP bearer

Query parameters

statusstring[]

Comma list of draft, scheduled, failed, published. Default draft,scheduled,failed. published items are publish records, never Drafts.

account_idstring

Only items on this account (acc_...), or none for Drafts with no account. Omitted: all of yours.

fromstring

Only items whose date is at or after this instant (inclusive).

tostring

Only items whose date is before this instant (exclusive).

order'desc' | 'asc'

Sort by the item's date: desc (default) or asc.

limitinteger

Max items per page (1-100, default 20).

cursorstring

Pagination cursor from a previous response; pass it back verbatim with the same filters.

Response

Drafts and publish records, ordered by each item's own date: scheduled_at for scheduled, failure.failed_at for failed, published_at for published, updated_at for draft.

object'draft_list' required

Response type discriminator.

cursorstring nullable required

Pass back as cursor for the next page; null on the last page.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.