Configured tool · read-only

`get_media`

Verify one uploaded media handle before publishing it.

read-onlynon-destructiveclosed-world

Human and agent roles

Configured boundary

Configured workspace

This org-scoped read can inspect only handles created inside the configured workspace. It cannot read arbitrary R2 keys or make pending or failed media publishable.

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.

FieldTypeContract

media_handleRequired

pd_media_…

Valid Postdom media handle

The handle returned by upload_media.

Synthetic values

Example call

Identifiers and values are examples. They do not represent a connected workspace or accepted media source.

EXAMPLE CALL · CONFIGURED TOOL SCHEMA

get_media({
  media_handle: "pd_media_11111111-1111-4111-8111-111111111111"
})

Observed API record

Return shape

Returns pending, stored, or failed after Postdom verifies the uploaded object.

media_handle · statusidentity · state: The exact handle and pending, stored, or failed state.
content_type · size_bytesdeclared media: The upload contract values checked against the stored object.
media_urlURL | null: Internal resolved media URL when stored; null otherwise.
failure_reasonstring | null: Why verification failed, when available.

Stop conditions

Agent handoff

pending

Wait briefly

Poll again with bounded backoff; do not submit the handle yet.

stored

Publish by handle

Pass media_handle to publish_video and omit video_url.

failed

Return the reason

Stop and preserve the exact failure reason; create a fresh upload only after correcting the source.