Configured tool · read-only
get_publish
Read one post state, every destination outcome, and structured approval feedback.
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.
post_idRequiredstringThe Postdom post to read.
Synthetic values
Example call
Identifiers and values are examples. They do not represent a connected workspace or accepted media source.
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_approvalWait for a human
Stop until the supervisor resolves the request.
changes_requestedReturn feedback
Give the exact state and structured feedback to the human supervisor. The configured contract exposes no post-revision call.
draft · missed_approval · missed_scheduleReturn control
A human can publish or reschedule these recoverable states.
scheduled · publishingKeep reading
Poll only inside the caller's configured budget.
publishedMeasure the post
Report success, then use get_performance when measurement is requested.
partial · failed · rejectedReport evidence
Return the exact post state and every failed destination.