Get started

The post object

What the posts endpoints return.

Fields

idstring

1Threads' id for the post.

accountstring | null

Id of the account it publishes from.

statusstring

draft, scheduled, publishing, published or failed.

textstring

The post's text, spoiler markup included.

mediaarray

Attachments: id, type (image or video), url, name and alt.

optionsobject

See Post options; empty when none are set.

scheduledAtISO 8601 | null

Publish time, or a draft's planned day.

publishedAtISO 8601 | null

When it went live.

threadsIdstring | null

Threads media id once published.

permalinkstring | null

Link to the post on Threads.

errorstring | null

Why publishing failed, or that it will retry automatically.

createdAtISO 8601

When the post was created in 1Threads.

updatedAtISO 8601

When it last changed.

Example

{
  "id": "6f1c2b9e-3a1d-4c7e-9f0a-1b2c3d4e5f60",
  "account": "29145472575138133",
  "status": "scheduled",
  "text": "Shipping the new release today 🚀",
  "media": [
    {
      "id": "efa6aa69-6625-421a-881e-360535c0e2e2.png",
      "type": "image",
      "url": "https://smanager.mrfirdavs.uz/media/efa6aa69-6625-421a-881e-360535c0e2e2.png",
      "name": "release.png",
      "alt": "Screenshot of the new dashboard"
    }
  ],
  "options": {
    "topic": "buildinpublic"
  },
  "scheduledAt": "2026-11-02T09:00:00.000Z",
  "publishedAt": null,
  "threadsId": null,
  "permalink": null,
  "error": null,
  "createdAt": "2026-10-28T11:03:10.445Z",
  "updatedAt": "2026-10-28T11:03:10.445Z"
}