Posts

Update a post

Change a draft, scheduled or failed post.

PATCH / posts / {id}

curl -X PATCH "https://smanager.mrfirdavs.uz/api/v1/posts/6f1c2b9e-3a1d-4c7e-9f0a-1b2c3d4e5f60" \
  -H "Authorization: Bearer $ONETHREADS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledAt": "2026-11-03T18:30:00Z"
  }'

{
  "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-03T18:30:00.000Z",
  "publishedAt": null,
  "threadsId": null,
  "permalink": null,
  "error": null,
  "createdAt": "2026-10-28T11:03:10.445Z",
  "updatedAt": "2026-10-28T11:03:10.445Z"
}

Send only the fields to change. media and options replace what the post had. Giving a failed post a new scheduledAt queues it again. Published posts can't be edited.

Authorizations

Authorizationheaderrequired

Bearer <key>. Needs a read & write key.

Path parameters

idstringrequired

The post's id.

Body (application/json)

textstring

New text.

mediaarray

New attachments, replacing the old ones.

optionsobject

New options, replacing the old ones.

scheduledAtISO 8601 | null

New time; null clears a draft's date.

statusstring

draft to unschedule, scheduled to queue (needs a future scheduledAt).