> ## Documentation Index
> Fetch the complete documentation index at: https://www.posted.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# get_media_status

> Get media status with Posted MCP.

Read media preparation status and its metadata when ready.

## Workflow

```mermaid theme={"system"}
flowchart LR
  step0["Read media state"] --> step1
  step1["Wait while processing"] --> step2
  step2["Use the media ID when ready"]
```

## Access and behavior

A Read-only, Write or Administrator OAuth grant can call this tool within the user’s current team role. Tools are listed and callable only when the current grant and role permit them.

A processing result contains the state only. A ready result includes metadata. Failed video preparation returns an error instead of making media publishable.

## Arguments

| Argument | Required | Type or meaning |
| - | - | - |
| `mediaId` | Yes | Private media UUID returned by reserve\_media\_upload. |

<Accordion title="Complete input schema">
  ```json theme={"system"}
  {
    "type": "object",
    "properties": {
      "mediaId": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      }
    },
    "required": ["mediaId"],
    "additionalProperties": false
  }
  ```
</Accordion>

## Example call

The client initializes the MCP connection before sending this JSON-RPC call. Example records are fictional.

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_media_status",
    "arguments": {
      "mediaId": "44444444-4444-4444-8444-444444444444"
    }
  }
}
```

## Example result

Posted returns this object in `structuredContent` and a JSON text content block. A tool failure sets `isError`; never treat an error as a completed mutation.

```json theme={"system"}
{
  "state": "ready",
  "media": {
    "id": "44444444-4444-4444-8444-444444444444",
    "fileName": "studio.jpg",
    "contentType": "image/jpeg",
    "sizeBytes": 245760,
    "width": 1600,
    "height": 900,
    "alt": "A bright studio desk beside a window",
    "durationSeconds": null
  }
}
```

## Related reference

[HTTP operation](/api-reference/get_api_media_by_mediaId_status) · [Connect an MCP client](/mcp-connections) · [Request conventions](/api-reference/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.