get_branded_video

mcp:readread-only

Check a render started with create_branded_video. While status is queued or rendering, wait about 15 seconds and call again. When done, postMedia is the finished video: pass it as media to create_draft_post or update_post, and show the user its url. captions lists the subtitles as burned in.

When failed, error says why.

Input

• renderIdstring (uuid)required

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_branded_video",
    "arguments": {
      "renderId": "3f8e2c1a-0000-4000-8000-000000000000"
    }
  }
}

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/marketing/videos/branded/{renderId} as the signed-in user, with the same validation, approval rules and limits. See it in the Videos API reference.