Post

idstring<uuid>

contentstring

statusstring

Aggregate status derived from per-destination publish state. 'publishing' = at least one destination is still in flight; 'partially_failed' = some destinations published and some failed.

Possible values: [draft, scheduled, publishing, published, partially_failed, failed]

account_idsinteger[]

Account IDs this post targets. Same name as the create-post request field — round-trip safe.

scheduled_forstring<date-time>nullable

UTC ISO 8601 when the post will publish (or did publish). Same name as the request field. Always Z-suffixed UTC.

timezonestring

IANA timezone for display. Defaults to "UTC".

media_idsstring<uuid>[]

Attached media IDs. Same name as the create-post request field.

mediaobject[]nullable

Hydrated media objects with full metadata (url, type, dimensions, etc.). For round-trip, use media_ids instead — it has the same names as the request field.

destinations object[]

Array [

idstring<uuid>

platformstring

statusstring

account_namestringnullable

account_idintegernullable

scheduled_forstring<date-time>

When THIS destination publishes. The scheduler fires by this value, not the post-level scheduled_for. After a reschedule it should match the post-level value; a mismatch means the edit didn't fully propagate.

published_atstring<date-time>nullable

platform_post_idstringnullable

errorstringnullable

attemptsinteger

]

created_atstring<date-time>

When this post record was created (UTC). NOT the same as scheduled_for.

updated_atstring<date-time>

Post

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "content": "string",
  "status": "draft",
  "account_ids": [
    0
  ],
  "scheduled_for": "2024-07-29T15:51:28.071Z",
  "timezone": "string",
  "media_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "media": [
    {}
  ],
  "destinations": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "platform": "string",
      "status": "string",
      "account_name": "string",
      "account_id": 0,
      "scheduled_for": "2024-07-29T15:51:28.071Z",
      "published_at": "2024-07-29T15:51:28.071Z",
      "platform_post_id": "string",
      "error": "string",
      "attempts": 0
    }
  ],
  "created_at": "2024-07-29T15:51:28.071Z",
  "updated_at": "2024-07-29T15:51:28.071Z"
}