Skip to content

content_publications_get

Read one publication: its state, its slot, and where it ended up.

Tool

content_publications_get

Read one publication: its state, its slot, and where it ended up.

Read one publication: its state, its slot, and where it ended up.

Behavior

HTTP
GET /content/publications/:id

Arguments

NameTypeRequiredDescription
idstringThe publication id returned by content_publications_schedule.

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

Read one publication: its state, its slot, and where it ended up.

When to use

Read one publication: its state, its slot, and where it ended up.

Example

Ask your agent something like this:

Read one publication: its state, its slot, and where it ended up.

The agent will invoke content_publications_get with these arguments:

{
  "id": "<id>"
}

Esc

Start typing to search the docs.

navigateselect