Posts

List posts

Every post in 1Threads' queue, ordered by scheduled time.

GET / posts

curl "https://smanager.mrfirdavs.uz/api/v1/posts?status=scheduled%2Cfailed" \
  -H "Authorization: Bearer $ONETHREADS_KEY"

{
  "data": [
    {
      "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"
    }
  ]
}

Drafts, scheduled, publishing, failed and published posts that live in 1Threads. Posts made directly on Threads aren't listed; read those with Published posts.

Authorizations

Authorizationheaderrequired

Bearer <key>. Any key works, read-only included.

Query parameters

accountstring

The key's account (id or username). Posts of other accounts are never listed.

statusstringdefault: all

Comma-separated: draft, scheduled, publishing, published, failed.

fromISO 8601

Only posts scheduled or published at or after this time.

toISO 8601

Only posts before this time.