List tools

GET

/v1/convai/tools

GET

/v1/convai/tools

curl https://api.elevenlabs.io/v1/convai/tools

{
  "tools": [
    {
      "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": {
                "description": "string",
                "type": "string"
              },
              "path": "string"
            }
          ],
          "is_error": false
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Get all available tools in the workspace.

Query parameters

searchstring or nullOptional

If specified, the endpoint returns only tools whose names start with this string.

page_sizeinteger or nullOptional1-100

How many documents to return at maximum. Can not exceed 100, defaults to 30.

show_only_owned_documentsbooleanOptionalDefaults to falseDeprecated

If set to true, the endpoint will return only tools owned by you (and not shared from somebody else). Deprecated: use created_by_user_id instead.

created_by_user_idstring or nullOptional

Filter tools by creator user ID. When set, only tools created by this user are returned. Takes precedence over show_only_owned_documents. Use ‘@me’ to refer to the authenticated user.

typeslist of enums or nullOptional

If present, the endpoint will return only tools of the given types.

Allowed values:

sort_directionenumOptional

The direction to sort the results

Allowed values:

sort_byenum or nullOptional

The field to sort the results by

Allowed values:

used_by_agent_idstring or nullOptional

Filter to tools referenced by this agent’s main branch: tools attached to the agent, tools on authored workflow nodes, and tools referenced by procedures.

cursorstring or nullOptional

Used for fetching next page. Cursor is returned in the response.

Response

Successful Response

toolslist of objects

has_moreboolean

next_cursorstring or nullOptional

Errors

422

Unprocessable Entity Error

Headers

Query parameters

Response

Errors