v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

List Web Tools

Retrieves a paginated list of web tools with optional filtering by project, status, type, collection, and search term.

get/v2/voice-agents/web-tool/list

Query parameters

isActiveboolean

Example:true

Filter by activation status

returnUncategorizedboolean

Return only web tools that are not in any collection. Cannot be used with collectionId.

voiceAgentIdstring uuid

Example:48f7656f-098b-4c43-b165-7cfd2cc8ac30

The unique identifier of the voice agent to filter by

skipinteger

Example:1

Page number for pagination (1-based)

takeinteger

Example:10

Number of items per page

searchstring

Example:Weather API

Search web tools by name

type'FUNCTION' | 'MCP' | 'WEB_TOOL'

Example:FUNCTION

Filter by web tool type

collectionIdstring uuid

Example:48f7656f-098b-4c43-b165-7cfd2cc8ac30

Filter by collection ID. Cannot be used with returnUncategorized=true.

Response

Successful response

successboolean

Example response

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "48f7656f-098b-4c43-b165-7cfd2cc8ac30",
        "persistentId": "48f7656f-098b-4c43-b165-7cfd2cc8ac30",
        "version": 1,
        "name": "Get Weather Data",
        "type": "FUNCTION",
        "userId": "48f7656f-098b-4c43-b165-7cfd2cc8ac30",
        "projectId": "48f7656f-098b-4c43-b165-7cfd2cc8ac30",
        "isActive": true,
        "description": "Fetches current weather data for a given location",
        "collectionId": "48f7656f-098b-4c43-b165-7cfd2cc8ac30",
        "messages": [
          {
            "type": "REQUEST_START",
            "content": "Fetching weather data..."
          }
        ]
      }
    ],
    "total": 25,
    "filtered": 10
  }
}