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.

Run post_example_08
partial
27 Aug · 09:00 UTCUpdated 09:02:14 UTC
Instagram ReelsPublished at 09:00:18 UTC
published
YouTube ShortsPublished at 09:00:41 UTC
published
TikTokprovider_down · provider unavailable
failed
Synthetic contract fixture · not customer data2 published · 1 failed

One request · separate evidence

Every answer stays separate.

The post state summarizes the whole run. Destination states preserve what happened on each selected account.

Overall postpartial

One durable summary of the complete request.

Instagram Reelspublished
YouTube Shortspublished
TikTokfailed

Run timeline

Read the run.

Exposed timestamps show when work was scheduled, when a destination published, and when the durable record last changed.

  1. 01scheduled_for

    The exact UTC slot Postdom was asked to hold.

  2. 02published_at

    Instagram confirms publication without changing the other answers.

  3. 03updated_at

    The 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 states
Published2Two destinations published
Failed1One destination failed
Overall statepartial

Failure evidence

Failure keeps its reason.

Postdom returns the recorded code and detail instead of collapsing the run into a generic error.

Failed destinationTikTok
Error codeprovider_down
Recorded detail

The provider or durable publish worker was unavailable when this publish ran.

Agent action

Return the exact failed destination and reason to a human. Do not rename the state.

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.

01

Keep reading

scheduledpublishing

Poll only inside the caller's configured budget.

02

Wait for review

requires_approval

A human must resolve the individual approval decision.

03

Return control

draftchanges_requestedrejectedmissed_approvalmissed_schedule

Give the exact state, post ID, and feedback to a human.

04

Report evidence

publishedpartialfailed

Return 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.

Post11 states
draftrequires_approvalchanges_requestedrejectedmissed_approvalmissed_schedulescheduledpublishingpublishedpartialfailed
Destination4 states
queuedsentpublishedfailed

Agent-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