Sign in

v4

OpenAPI 3.1.02026-07-313621,3961.8 MB
Agents Platform

Create Mcp Server Tool Approval

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

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

Path parameters

mcp_server_idstring required

ID of the MCP Server.

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.

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