complete_media_upload

Access and behavior

Write or Administrator OAuth consent and a member/administrator team role are required. Tools are listed and callable only when the current grant and role permit them.

Images can become ready immediately. Videos normally return state processing with HTTP 202 and must finish preparation before a post can use them. Invalid bytes or size are rejected.

Arguments

Argument	Required	Type or meaning
`mediaId`	Yes	Private media UUID returned by reserve_media_upload.

Complete input schema

{
  "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
}

Example call

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "complete_media_upload",
    "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.

{
  "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
  }
}

Connect a client

MCP reference

API Reference

complete_media_upload

Workflow

Access and behavior

Arguments

Example call

Example result

​Workflow

​Access and behavior

​Arguments

​Example call

​Example result

​Related reference

Workflow

Access and behavior

Arguments

Example call

Example result

Related reference