Skip to main content
GET
List tools

Authorizations

X-API-Key
string
header
required

[Production] API key for production authentication

Query Parameters

projectId
string

The unique identifier for the project to filter by.

filter
string

The string to filter by name. The filter is case-insensitive.

limit
integer
default:100

The maximum number of items to return, from 1 to 100. The default is 100.

skip
integer
default:0

The number of items to skip before starting to return results. The default is 0.

sort
string
default:asc

The sort order. Use asc or desc to sort by _id, or <field>:<asc|desc> to sort by one of _id, name, lastChangedAt or createdAt. The default is asc.

next
string

The cursor for the next page of results. It is only valid with the default _id sort. To page through a sorted list, use skip and limit.

previous
string

The cursor for the previous page of results. It is only valid with the default _id sort. To page through a sorted list, use skip and limit.

agentReferenceId
string

The referenceId of an agent. Returns only the tools available to this agent, whether attached directly or bundled in a skill it has hired. Requires projectId. Disabled tools are included.

source
string

A comma-separated list of tool sources to filter by. The allowed values are extension, managed, builtin and mcp.

mcpServerReferenceId
string

The referenceId of an MCP server. Filters MCP tools to that server.

includeHidden
boolean
default:false

If set to true, the response also includes system-managed tools that are left out by default: hidden rows and voice-config-defaults instances, which are managed from Voice Studio. The default is false.

Response

OK

items
object[]
nextCursor
string
Example:

"507f1f77bcf86cd799439011"

previousCursor
string
Example:

"507f1f77bcf86cd799439017"

total
integer
Example:

1