Describe, move or delete a media file
manage_media_file[Admin] With action update (the default): change a file's name, alt text, focal point or poster, or move it to another folder ("" is the top). Fields left out keep their value. alt replaces the whole set of languages. A null focal_x, focal_y or poster_url clears it. A move gives the file a new url: live pages keep the old one and page drafts move at once (drafts_updated). With action delete and only media_id: delete the file for good; this cannot be undone. Refused while a page, brand, CSS file, style setting, company logo or branding, interview, position, blog post, avatar or coaching catalogue uses it: the error lists what does, and those uses are changed separately.
Every argument in full, with examples: get_tool_reference.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"media_id": "<media_id>"
},
"name": "manage_media_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alt | No | Alt text per language code. Replaces the whole set, so send every language. | |
| action | No | `update` (default) changes the fields you send. `delete` deletes the file: send only media_id. It is refused with 409 while a page, brand, CSS file, style setting, company logo or branding, interview, position, blog post, avatar or coaching catalogue uses it (the answer lists what does); it cannot be undone. | |
| folder | No | Move the file to this folder; "" is the top. The file gets a new address in that folder; the old address keeps working for published pages, and page drafts move to the new one. | |
| focal_x | No | Horizontal focal point, 0 (left) to 1 (right). Null clears it. | |
| focal_y | No | Vertical focal point, 0 (top) to 1 (bottom). Null clears it. | |
| media_id | Yes | The file to change. | |
| file_name | No | Display name in the library. | |
| llm_model | No | Your model id, e.g. "claude-opus-4-8"; "unknown" if unsure. For analytics. | |
| poster_url | No | Still image shown before a video plays: the `url` of an image in this company's library. Null removes it. | |
| conversation_id | No | The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| alt | No | ||
| url | No | ||
| kind | No | ||
| path | No | ||
| width | No | ||
| folder | No | ||
| height | No | ||
| status | Yes | ||
| focal_x | No | ||
| focal_y | No | ||
| version | No | ||
| warnings | No | ||
| file_name | No | ||
| read_only | No | ||
| created_at | No | ||
| poster_url | No | ||
| size_bytes | No | ||
| updated_at | No | ||
| merchant_id | No | ||
| content_type | No | ||
| drafts_updated | No | ||
| duration_seconds | No | ||
| _mcp_instructions | No | Server-issued metadata for this conversation. |