List builtin tools
Read what a built-in tool does and what arguments it takes, without adding it to an agent. Omit `template` to list every template with its summary line, required arguments, and parameter names. Pass one `template` for that tool's full description and JSON-Schema parameters. Call this before add_builtin_tool to pick the right template, and before writing a prompt or an `<example>` that shows the agent using one: a builtin's arguments are injected by the Python runtime at call time and stored as `{}` on the tool row, so get_agent cannot report them.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/list_builtin_tools" \ -H "Content-Type: application/json" \ -d '{ "agent": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Find connectable apps POST
Search the app catalogue to find the exact app slug for initiate_agent_connection. Returns `{ slug, name, description, connectKind, connectableViaMcp }` per app. `connectKind` is 'managed' (one-click), 'byo_key' (the user enters an API key on a hosted sign-in page, still connectable here), or 'byo_oauth' (needs the operator's own OAuth app, so connect it in Connected apps in the app, NOT via initiate_agent_connection, `connectableViaMcp` is false for those). Paginated: the catalogue is ~1000 apps, so pass a `search` term and page with the returned `nextCursor`.
List call alerts POST
List every real-time call alert in this workspace, the 6 built-in reasons (new_lead/urgent/missed/message_taken/booking/all_calls) that have been turned on, plus any free-form custom alerts. Each entry carries its id, reason (null for a custom alert), name, description, enabled state, its email/SMS recipients, its Slack channel ids, whether it skips the team's own calls, and its optional custom template. The envelope also lists the workspace's connected Slack channels under `slackChannels` ({id, label}), the ids create_call_alert/update_call_alert accept in slackChannelIds. Call this first to resolve the id update_call_alert/delete_call_alert need, and to see what's already covered before creating a duplicate.