Account
A saved social account record inside one Postdom workspace. Agent calls use its account ID when selecting a publishing destination or measurement scope.
Account setupCanonical vocabulary
One definition layer for the humans setting boundaries, the agents doing the work, and the systems reading the result.
Friendly language explains the product. Exact wire values still travel unchanged.
Contract language verified 26 August 202646 of 46 definitions
A saved social account record inside one Postdom workspace. Agent calls use its account ID when selecting a publishing destination or measurement scope.
Account setupThe human-selected L0–L3 authority mode on a connected account. It determines whether publishing is manual, reviewed per post, approved by plan, or allowed inside saved bounds.
Authority modesThe evidence status attached to a modeled metric field: available, delayed(2-3d), estimable, never, or unverified. It must remain attached to the returned value or null.
Availability statesavailableAn availability state saying the modeled evidence baseline exposes the field. The returned value can still be null and must be preserved exactly.
Availability statesA ranking of one connected account's posts by one supported metric inside a 7-day or 30-day publication window. Null observations are excluded, never ranked as zero.
get_best_postsA social account whose provider authorization has been completed by a human and whose Postdom record can be selected by account ID.
Account readinessThe maximum number of posts an L3 account policy authorizes in that account's local day. A human can edit the cap or choose a stricter authority mode.
Policy boundsdelayed(2-3d)An availability state saying a field is expected after a two-to-three-day evidence delay. It is not a guarantee that a value will arrive.
Availability statesOne provider-and-account target selected for a post. A single post can have several destinations, and each destination keeps its own state and outcome.
Runs and outcomesThe exact state of one destination inside a post: queued, sent, published, or failed. It is separate from the post's overall state.
Run statesestimableAn availability state saying suitable evidence could support a derived value. Postdom does not promise that the value has been estimated or that a computation exists.
Availability statesA post observation left out of a best-post ranking because the requested metric value is null. The exclusion retains its availability state and reason where supplied.
get_best_postsfailedA destination state entered when the provider or local watchdog records failure for that destination. The returned error code and detail remain part of its answer.
Run statesfailedA post state entered when every destination fails or execution fails locally. It can retain recoverable evidence, but remains a recorded failure until reconciliation changes it.
Run statesA named Postdom operation exposed to a configured agent through the Model Context Protocol, with a machine-readable input and return schema.
Tool referencemissed_scheduleA recoverable post state entered when execution begins more than 15 minutes after the scheduled time. Postdom stops instead of publishing late and returns control to a human.
Run statesneverAn availability state saying the platform does not expose the field. The normalized value remains null and includes an explicit reason.
Availability statesA Postdom field that gives comparable meaning to evidence returned from supported destinations while preserving its source, observation time, and availability state.
MeasurementnullThe absence of an evidence-backed metric value. Null is not zero and must stay paired with its availability state; only never and unverified guarantee a reason.
Zero and null0A measured numeric value of nothing. Zero is evidence and must never be converted to null or treated as missing.
Zero and nullThe timestamp attached to evidence showing when Postdom observed or generated that read. It is not the post's scheduled or published time.
get_performancepartialA post state used when published and failed destination outcomes coexist. Every destination answer remains visible; partial is not a vague sent status.
Runs and outcomesA human control that blocks execution for one account or blocks agent write activity across the workspace. Only a human can resume paused activity.
Human authorityA set of normalized metric observations for a post at a recorded observation time, with source and availability metadata preserved for every modeled field.
MeasurementA stored proposal for selected accounts, a UTC time window, an objective, and a maximum number of posts. At L2 it becomes an authorization boundary only after human approval.
Schedules and plansThe recorded result of evaluating a publish request against an approved plan's accounts, window, state, and remaining capacity.
get_publishDescriptive evidence for one approved plan's completed work. An agent can read it before proposing later work, but Postdom does not turn it into a recommendation.
get_performanceThe UTC start and end timestamps bounding when an approved plan can authorize eligible posts. It is not the schedule itself.
Schedules and plansThe durable Postdom record for one submitted video, caption, intent, schedule, authorization evidence, and one or more destination outcomes.
Runs and outcomesThe exact overall state of a durable post record. It describes authorization and execution across all selected destinations and must not be renamed by an agent.
Run statespublishedA destination state entered when the provider confirms publication for that destination. It retains the provider identifiers and publication evidence returned to Postdom.
Run statespublishedA post state entered only when every selected destination is recorded as published. It is distinct from one destination publishing successfully.
Run statespublish_atThe optional RFC 3339 UTC timestamp on publish_video that asks Postdom to schedule the post for an exact future time.
publish_videoA saved local-time window in an L3 account policy during which new work is not authorized. The account timezone determines how the window is evaluated.
Policy boundsqueuedA modeled destination state reserved in storage before provider handoff. No configured production path currently creates it, so agents must not expect it from the provider result.
Run statesA buyer-facing name for one durable post record moving from accepted work through destination outcomes and measurement. The public wire contract exposes a post, not a separate run resource.
Runs product pageThe future publishing work Postdom holds against exact UTC targets. It is a product concept represented by durable posts, not a separate public API resource.
Schedules and planssentA destination state saying the provider accepted the destination request. Sent is not published; the agent must keep reading for authoritative destination evidence.
Run statesThe selected destination account with the lowest autonomy level in a multi-account request. Its level governs the whole request; Postdom does not split authorization.
Multi-account authorityA recorded completion state: published, partial, or failed. It ends normal polling, although recoverable local evidence can later reconcile partial or failed outcomes.
Runs and outcomesunverifiedAn availability state saying recorded evidence has not verified whether the field is exposed. The normalized value is null and includes an explicit reason.
Availability statesThe set of publishing visibility values a human permits in an L3 account policy. Work outside the saved allowlist is not authorized.
Policy boundsA comparison between the latest two completed account-local weeks. It describes movement in returned evidence; it does not establish causality or recommend the next action.
Performance product pageThe human-owned Postdom boundary containing members, keys, connected accounts, policy, the Workspace Brief, plans, posts, and returned evidence.
Docs quickstartVersioned workspace guidance for brand voice, captions, hashtags, timing context, and never-dos. A connected agent reads the current version before planning or writing.
get_briefA scoped credential an owner, admin or member creates for a configured agent connection. Postdom shows its exact MCP configuration once; the key stays out of chat and source control.
Agent quickstartCommonly confused
The pair is close enough to sound interchangeable—and different enough to produce the wrong action.
A plan is an approval boundary. A schedule is the future work Postdom holds and executes.
A post is the durable overall record. A destination is one provider-and-account outcome inside it.
Sent means the provider accepted a request. Published requires later destination evidence.
Zero is measured evidence. Null means no evidence-backed value was returned.
Estimable says suitable evidence could support a value. It does not say a value was computed.
For AI agents
Use these definitions to interpret the contract, never to rewrite it. Keep state names, IDs, timestamps, numeric zero, null, availability, and supplied reasons exactly as returned.
missed_scheduledelayed(2-3d)null ≠ 0Canonical contract
The glossary explains meaning. Tool schemas and reference pages remain authoritative for callable fields and exact state transitions.