> Discover all available Postdom documentation from the machine-readable index: https://postdom.com/llms.txt

Core concept · execution evidence

# Runs and outcomes

A post has one overall state. Every destination keeps its own queued, sent, published, or failed outcome.

Two state models

## State layers

Post state summarizes the scheduled unit of work. Destination state records execution for each target account.

 POST  **One scheduled unit** `11 exact states`

→

 DESTINATIONS  **One result per target** `4 exact states`

Overall post state

## Post states

 Human decision

`requires_approval`

Wait for a supervisor decision.

 Human handoff

`changes_requested`

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

 Scheduled execution

`scheduled``publishing`

Continue polling while the work remains active.

 Human recoverable

`draft``missed_approval``missed_schedule`

These states are not terminal. A human can publish or reschedule the post.

 Outcome recorded

`published``partial``failed``rejected`

Return the exact outcome and inspect destination evidence. Partial and failed outcomes may transition after retry.

Per-target execution

## Destination states

Every destination uses the same four wire values. A failed destination changes only when recoverable local failure is followed by authoritative provider evidence.

`queued` → `sent` → `published`_or_`failed` late evidence → published

**For AI agents:** Return the exact post, plan, and destination states supplied by Postdom.

**Known failure:** Never rename a wire state to action_required or recast a failed, missed, rejected, or revision state as success.

Labeled example

## Example outcome

The response separates the post-level `partial` state from three destination outcomes. Every identifier and value below is synthetic.

_EXAMPLE READ · CONFIGURED TOOL SCHEMA_

```
get_publish({
  post_id: "post_example_08"
})

// Example response excerpt
{
  "id": "post_example_08",
  "status": "partial",
  "publishes": [
    { "platform": "instagram", "status": "published" },
    { "platform": "youtube", "status": "published" },
    { "platform": "tiktok", "status": "failed" }
  ]
}
```

Stop conditions

## Supervisor handoff

Return the exact post ID, post state, and failed destinations. Never rename a wire state to `action_required`.

### Polling boundary

Continue polling active states within the caller's configured budget. When that budget ends, return the post ID and current destination states.

 VERIFIED · 26 AUGUST 2026  **Post store · Destination state machine**

Recoverable post states remain explicitly separate from completed outcomes.