Runs and outcomes
One post. Every destination answers.
Postdom keeps one overall post state and a separate recorded outcome for every selected account. Partial success stays visible. Failure keeps its reason.
One request can publish on two accounts and fail on a third. Your agent sees all three answers.
One request · separate evidence
Every answer stays separate.
The post state summarizes the whole run. Destination states preserve what happened on each selected account.
One durable summary of the complete request.
Run timeline
Read the run.
Exposed timestamps show when work was scheduled, when a destination published, and when the durable record last changed.
- 01
scheduled_forThe exact UTC slot Postdom was asked to hold.
- 02
published_atInstagram confirms publication without changing the other answers.
- 03
updated_atThe failed TikTok answer makes the overall run partial.
Partial success
Partial stays visible.
A successful destination never hides a failed one. The overall state remains partial while published and failed answers coexist.
Read exact run statesFailure evidence
Failure keeps its reason.
Postdom returns the recorded code and detail instead of collapsing the run into a generic error.
provider_downThe provider or durable publish worker was unavailable when this publish ran.
Agent handoff
Know when to stop.
The wire state tells the agent whether to keep reading, wait for review, return control, or report the recorded outcome.
Keep reading
scheduledpublishingPoll only inside the caller's configured budget.
Wait for review
requires_approvalA human must resolve the individual approval decision.
Return control
draftchanges_requestedrejectedmissed_approvalmissed_scheduleGive the exact state, post ID, and feedback to a human.
Report evidence
publishedpartialfailedReturn the post state and every recorded destination answer.
Closed state model
Exact state vocabulary.
Postdom exposes eleven post states and four destination states. Agents preserve these values exactly.
draftrequires_approvalchanges_requestedrejectedmissed_approvalmissed_schedulescheduledpublishingpublishedpartialfailedqueuedsentpublishedfailedAgent-readable outcomes
The answer survives the dashboard.
get_publish returns the overall post state, every destination publish, plan authorization, approval feedback, agent context, and exposed timestamps.
The same rules are available as raw Markdown, so an agent can read the state boundary without scraping this page.
Runs FAQ
Outcome questions.
How do I know whether every platform published my post?01
Read the post with get_publish. Postdom returns one overall post state plus a separate queued, sent, published, or failed state for every selected destination.
What does a partial run mean?02
Partial means published and failed destination outcomes coexist on the same post. Postdom preserves every destination answer instead of presenting the run as complete success or complete failure.
Does Postdom retry a failed social post automatically?03
A partial or failed record may reconcile after a recoverable local failure is followed by authoritative provider evidence. The read contract itself does not retry, approve, revise, or reschedule work.
Which run states should an AI agent keep polling?04
The agent keeps reading scheduled and publishing states only within its configured polling budget. Approval, recoverable, partial, failed, and rejected states return to a human with the exact post ID and evidence.
Can an agent call a failed run action_required?05
No. action_required is not a Postdom wire state. The agent must preserve the exact post and destination states and return the recorded reason without renaming either one.
From request to answer
Close every run.
Give your agent one durable place to read what published, what failed, and what needs a human.
Create a workspace