get_media

Get metadata for an uploaded media file. Returns id, url, type, mimeType, sizeBytes, status (pending/ready/expired), filename, and expiration date.

Parameters

When to use

Look up a single media record. Useful after create_upload_url to confirm the upload was completed before referencing the media in a post, or to inspect metadata (size, mime, alt text) of an existing asset.

Example

{
  "workspaceId": "wks_01H...",
  "mediaId": "med_01H..."
}

Response shape:

{
  "id": "med_01H...",
  "type": "image",
  "mimeType": "image/jpeg",
  "sizeBytes": 284721,
  "status": "uploaded",
  "url": "https://storage.postato.com.br/...",
  "createdAt": "2026-04-15T12:00:00Z"
}

Status values

• pending — created via create_upload_url but the PUT hasn't happened yet.
• uploaded — file is in storage and ready to attach to posts.
• failed — upload was never completed within the presigned URL's validity window.

Gotchas

• url is an internal Postato URL. Do not expose it to end users; agents should reference media by id in tool calls.
• The URL is stable but subject to signed-access policies for certain integrations (e.g., Meta). Re-fetching shortly before a publish is safer than caching long-term.