Tools

Create a new tool

Create an end_call or API tool for agents to use

Authentication

AuthorizationBearer

Clerk JWT token or OrtaVox API key (sk_live_… or pk_live_…)

OR
x-api-keystring

OrtaVox API key (alternative to Bearer token)

Request

This endpoint expects an object.
namestringRequired
Tool name
typeenumRequired
Tool type
Allowed values:
descriptionstringOptional

Tool description (optional, auto-generated if not provided)

urlstringOptional

API endpoint URL (required for api type)

methodenumOptional

HTTP method (required for api type)

Allowed values:
headersobjectOptional
HTTP headers for api type
parametersobjectOptional
JSON Schema for tool parameters

Response

Tool created successfully
dataobject or null

Errors