Browse docs

Configured tool · read-only

get_publish

Read one post state, every destination outcome, and structured approval feedback.

read-onlynon-destructiveclosed-world

Human and agent roles

Configured boundary

Configured workspace

This read reports execution evidence. It does not retry, approve, revise, reschedule, or change a destination.

This reference describes a connection made with @postdom/mcp@0.3.0 and a workspace-scoped agent key created in Accounts.

Callable schema

Input fields

Field names match the configured tool schema. Runtime-only constraints are labeled separately from schema validation.

FieldTypeContract
post_idRequired
string
Non-empty

The Postdom post to read.

Synthetic values

Example call

Identifiers and values are examples. They do not represent a connected workspace or accepted media source.

EXAMPLE CALL · CONFIGURED TOOL SCHEMA
get_publish({
  post_id: "post_example_08"
})

Observed API record

Return shape

Returns the durable post record with separate target and destination-publish evidence.

id · version · request_hashidentity
Post identity and immutable review reference.
statuspost state
One of the eleven exact post states.
caption · media_url · sourcecontent
Submitted content and request source.
agentobject
Calling identity and intent.
scheduled_for · approved_at · reviewed_atdatetime | null
Workflow timestamps when available.
created_at · updated_atdatetime
Durable record timestamps.
plan_id · plan_authorizationplan evidence | null
Plan reference and authorization result.
approval_feedbackobject | null
Structured decision, category, and text.
targetsarray
Requested account, platform, and nullable handle records.
publishesarray
Per-destination state, provider IDs, public URL, errors, attempts, and timestamps.

Stop conditions

Agent handoff

requires_approval

Wait for a human

Stop until the supervisor resolves the request.

changes_requested

Return feedback

Give the exact state and structured feedback to the human supervisor. The configured contract exposes no post-revision call.

draft · missed_approval · missed_schedule

Return control

A human can publish or reschedule these recoverable states.

scheduled · publishing

Keep reading

Poll only inside the caller's configured budget.

published

Measure the post

Report success, then use get_performance when measurement is requested.

partial · failed · rejected

Report evidence

Return the exact post state and every failed destination.

VERIFIED · 26 AUGUST 2026Configured MCP schema · GET /v1/posts/:id wire-contract mapper

Examples are synthetic. Human workspace-key creation and revocation remain in the authenticated Accounts screen.