Create a new tool

Create an end_call or API tool for agents to use

AuthorizationBearer

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

x-api-keystring

OrtaVox API key (alternative to Bearer token)

This endpoint expects an object.

namestringRequired

Tool name

typeenumRequired

Tool type

descriptionstringOptional

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

urlstringOptional

API endpoint URL (required for api type)

methodenumOptional

HTTP method (required for api type)

headersobjectOptional

HTTP headers for api type

parametersobjectOptional

JSON Schema for tool parameters

Tool created successfully

dataobject

400

Bad Request Error

$	curl -X POST https://api.ortavox.ai/v1/tools \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "API request",
>	"type": "api"
>	}'