Agents Platform

Create Mcp Server Tool Approval

Changed on

Add approval for a specific MCP tool when using per-tool approval mode.

post/v1/convai/mcp-servers/{mcp_server_id}/tool-approvals

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/convai/mcp-servers/{mcp_server_id}/tool-approvals
  • Auth
    none declared

Path parameters

mcp_server_idstring required

ID of the MCP Server.

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body

tool_namestring required

The name of the MCP tool

tool_descriptionstring required

The description of the MCP tool

input_schemaobject

The input schema of the MCP tool (the schema defined on the MCP server before ElevenLabs does any extra processing)

approval_policy'auto_approved' | 'requires_approval'

Defines the tool-level approval policy.

Response

Successful Response

idstring required

Changes

  • f053c821dc18Revision changes
    • breaking

      response property config/tool_config_overrides/items/input_overrides/anyOf[subschema #1]/additionalProperties/oneOf[subschema #1: ConstantSchemaOverride]/constant_value list-of-types was widened by adding types null to media type application/json of response 200

  • 1cae8adcc965Revision changes
    • info

      added the optional property / to the response with the status