public_register_media
Register Media. Spends ElevenLabs credits.
This record as markdown: /tools/aiwerk-mcp-server-elevenlabs/public-register-media.md
What public_register_media does on Elevenlabs
AI agents use public_register_media to create or update resources in Elevenlabs, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Elevenlabs environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
order_id | string | Yes | The ID of the order to which this media will be attached. |
media_url | string | null | — | A URL to fetch the media file from. Mutually exclusive with media. |
media_path | string | — | The media file to upload. Mutually exclusive with media_url. Local path. |
media_base64 | string | — | Base64 contents for "media". Use this when the server cannot read your local disk. |
media_filename | string | — | Filename to send for "media". Some endpoints infer the audio format from it. |
declared_language | string | Yes | The language code of the media content (e.g. 'en', 'es-ES'). Must be a supported source language for some order item kind. |
media_url_filename | string | null | — | The filename for URL-sourced media (e.g. 'example.mp4'). Required when using media_url. |
media_url_content_type | string | null | — | The MIME type for URL-sourced media (e.g. 'video/mp4'). Required when using media_url. |
Parameters from the server's own tool schema.
Why public_register_media is rated Medium
An AI agent can call public_register_media faster than any human can review: one bad instruction and it creates or modifies resources in Elevenlabs by the hundred, each call as confident as the last.
Attacks that exploit this kind of access
The rule that runs public_register_media safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Elevenlabs, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For public_register_media, this is the rule to start with:
public_register_media stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Elevenlabs, apply this rule, and every public_register_media call is checked against it from then on.
Questions about public_register_media
Register Media. Spends ElevenLabs credits. It is categorised as a Write tool in the Elevenlabs MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
public_register_media accepts 8 parameters: order_id, media_url, media_path, media_base64, media_filename, declared_language, media_url_filename, media_url_content_type. Required: order_id, declared_language. The full parameter table on this page comes from the server's own tool schema.
Register the Elevenlabs MCP server in PolicyLayer and add a rule for public_register_media: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Elevenlabs. Nothing to install.
public_register_media is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the public_register_media rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for public_register_media. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
public_register_media is provided by the Elevenlabs MCP server (@aiwerk/mcp-server-elevenlabs). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Elevenlabs, and thousands of servers like it.
This server
Across the catalogue