Create tool

curl -X POST https://api.elevenlabs.io/v1/convai/tools \
     -H "Content-Type: application/json" \
     -d '{
  "tool_config": {
    "type": "system",
    "name": "end_call",
    "params": {
      "system_tool_type": "end_call"
    },
    "description": ""
  }
}'

{
  "id": "string",
  "tool_config": {
    "type": "system",
    "name": "end_call",
    "params": {
      "system_tool_type": "end_call"
    },
    "description": ""
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "usage_stats": {
    "avg_latency_secs": 1.1,
    "total_calls": 0
  },
  "response_mocks": [
    {
      "mock_result": "string",
      "parameter_conditions": [
        {
          "eval": {
            "type": "string",
            "description": "string"
          },
          "path": "string"
        }
      ]
    }
  ]
}

Add a new tool to the available tools in the workspace.

Request

This endpoint expects an object.

tool_configobjectRequired

Configuration for the tool

response_mockslist of objects or nullOptional

Mock responses with optional parameter conditions. Evaluated top-to-bottom; first match wins.

Response

Successful Response

idstring

tool_configobject

The type of tool

access_infoobject

usage_statsobject

response_mockslist of objects or null

Mock responses with optional parameter conditions. Evaluated top-to-bottom; first match wins.

Errors

422

Unprocessable Entity Error

Create tool

Headers

Request

Response

Errors

Headers

Request

Response

Errors

$	curl -X POST https://api.elevenlabs.io/v1/convai/tools \
>	-H "Content-Type: application/json" \
>	-d '{
>	"tool_config": {
>	"type": "system",
>	"name": "end_call",
>	"params": {
>	"system_tool_type": "end_call"
>	},
>	"description": ""
>	}
>	}'

1	{
2	"id": "string",
3	"tool_config": {
4	"type": "system",
5	"name": "end_call",
6	"params": {
7	"system_tool_type": "end_call"
8	},
9	"description": ""
10	},
11	"access_info": {
12	"is_creator": true,
13	"creator_name": "John Doe",
14	"creator_email": "john.doe@example.com",
15	"role": "admin",
16	"access_source": "creator"
17	},
18	"usage_stats": {
19	"avg_latency_secs": 1.1,
20	"total_calls": 0
21	},
22	"response_mocks": [
23	{
24	"mock_result": "string",
25	"parameter_conditions": [
26	{
27	"eval": {
28	"type": "string",
29	"description": "string"
30	},
31	"path": "string"
32	}
33	]
34	}
35	]
36	}