Posts

Reschedule a queued post

Move a scheduled post to a new firing time. Only allowed when status=queued AND scheduledAt is still in the future — once a post enters publishing or any terminal state, the window closes and the request returns 409.

The operation is atomic: the API replaces the BullMQ job (removes the old delayed job, enqueues a new one at the updated delay) and only persists the new scheduledAt if the queue swap succeeded. A post.rescheduled webhook fires on success, carrying both the old and new timestamps.

PATCH

posts

{id}

Reschedule a queued post

curl --request PATCH \
  --url https://api.letmepost.dev/v1/posts/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scheduledAt": "2023-11-07T05:31:56Z"
}
'

{
  "error": {
    "code": "preflight_failed",
    "message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
    "rule": "bluesky.text.max_graphemes",
    "platform": "bluesky",
    "remediation": "Trim 12 graphemes, or split into a thread.",
    "docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
    "ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
    "requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
  }
}

Authorizations

Authorization

string

header

required

Mint an API key in the dashboard. See https://letmepost.dev/docs/authentication/.

Path Parameters

string

required

Body

application/json

scheduledAt

string<date-time>

required

ISO-8601 timestamp with timezone. Must be at least 1 second in the future.

Response

Reschedule applied; row reflects the new scheduledAt.

List uploaded mediaCursor-paginated. Scoped to the caller's organization, and (when the key is profile-scoped) to that profile. Org-wide keys may narrow with `?profileId=`.

Reschedule a queued post

curl --request PATCH \
  --url https://api.letmepost.dev/v1/posts/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scheduledAt": "2023-11-07T05:31:56Z"
}
'

{
  "error": {
    "code": "preflight_failed",
    "message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
    "rule": "bluesky.text.max_graphemes",
    "platform": "bluesky",
    "remediation": "Trim 12 graphemes, or split into a thread.",
    "docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
    "ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
    "requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
  }
}

Documentation Index

Authorizations

Path Parameters

Body

Response