Skip to content

content_publications_reschedule

Move a publication to a new time.

Tool

content_publications_reschedule

Move a publication to a new time.

Move a publication to a new time. It returns to the queue, and the reminder for the old slot is spent — a new one goes out at the new time.

Behavior

HTTP
POST /content/publications/:id/reschedule

Arguments

NameTypeRequiredDescription
idstringThe publication id returned by content_publications_schedule.
scheduledAtstringNew ISO-8601 time. The publication returns to the queue.

Response

FieldTypeAlwaysDescription
idstringPublication id.
textstringThe exact text that will be published to this channel — markdown already flattened to plain network text at schedule time. Not the markdown source; that stays on the post.
statestringpending (queued) -> publishing (the reminder was sent; a person is publishing by hand) -> published (confirmed) | failed | cancelled.
postIdstringThe post being published.
costUsdnumberWhat publishing this costs in USD, computed when it was scheduled. On X a post carrying a link costs 13x a plain one. Null means the cost is not known — an auto channel refuses to dispatch it.
attemptsintegerHow many dispatch attempts have been made.
channelIdstringThe channel it is published to.
costBasisstringWhich rate produced costUsd: "plain", "link" or "free".
createdAtstringISO-8601 creation time.
lastErrorstringThe most recent failure, if any.
updatedAtstringISO-8601 time of the last change.
externalIdstringThe network's id for the published post, once known.
externalUrlstringURL of the published post, once known.
publishedAtstringISO-8601 time it was confirmed published.
scheduledAtstringISO-8601 time the publication is due.
reminderCountintegerHow many reminders have been sent for this publication.
idempotencyKeystringThe key that makes a retry the same publication.
reminderSentAtstringISO-8601 time the most recent reminder went out, or null if none has.

Try it

Move a publication to a new time.

When to use

Move a publication to a new time. It returns to the queue, and the reminder for the old slot is spent — a new one goes out at the new time.

Example

Ask your agent something like this:

Move a publication to a new time.

The agent will invoke content_publications_reschedule with these arguments:

{
  "id": "<id>",
  "scheduledAt": "<scheduledAt>"
}

Esc

Start typing to search the docs.

navigateselect