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/v1/posts/{id}

Request

  • Base URL: https://api.letmepost.dev
  • URL: https://api.letmepost.dev/v1/posts/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

scheduledAtstring 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.

idstring required
profileIdstring required
accountIdstring required
platform'bluesky' | 'facebook' | 'instagram' | 'linkedin' | 'pinterest' | 'threads' | 'tiktok' | 'twitter' required

Supported platforms. tiktok posts upload to the creator's TikTok inbox as a draft that the creator confirms in the TikTok app; Direct Post is not implemented yet.

status'queued' | 'validated' | 'publishing' | 'published' | 'failed' | 'rejected' | 'canceled' required

Lifecycle state of a single per-target post row. canceled is the terminal state reached via DELETE /v1/posts/{id} on a queued scheduled post.

textstring required
scheduledAtstring date-time nullable required
publishedAtstring date-time nullable required
platformUristring nullable required
platformCidstring nullable required
errorunknown
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.