List tools

curl -G https://api.elevenlabs.io/v1/convai/tools \
     -H "Content-Type: application/json" \
     -d search=search \
     -d page_size=1 \
     -d show_only_owned_documents=true \
     -d created_by_user_id=created_by_user_id \
     -d sort_direction=asc \
     -d sort_by=name \
     -d cursor=cursor

{
  "tools": [
    {
      "id": "tool_8f3b2a1c",
      "tool_config": {
        "type": "client",
        "description": "Sends a notification event to the user's client application.",
        "name": "user_notification",
        "assignments": [
          {
            "dynamic_variable": "user_name",
            "value_path": "user.name",
            "source": "response",
            "sanitize": false
          }
        ],
        "dynamic_variables": {
          "dynamic_variable_placeholders": {
            "user_name": "John Doe"
          }
        },
        "expects_response": false
      },
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john.doe@example.com",
        "role": "admin"
      },
      "usage_stats": {
        "avg_latency_secs": 1.1,
        "total_calls": 152
      }
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0b29sX2lkIjoiY2xpZW50X251bWJlciIsInBhZ2UiOjF9"
}

Get all available tools in the workspace.

Query parameters

searchstringOptional

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

page_sizeintegerOptional1-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_idstringOptional

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.

typesenumOptional

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_byenumOptional

The field to sort the results by

Allowed values:

cursorstringOptional

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

Response

Successful Response

toolslist of objects

has_moreboolean

next_cursorstring or null

Headers

Query parameters

Response

Errors