Agents

Agents define prompt behavior, tools, voice settings, status, and phone number routing.

Common operations

Method	Path	Description
GET	/v1/agents	List agents
POST	/v1/agents	Create an agent
GET	/v1/agents/{agent_id}	Get one agent
PATCH	/v1/agents/{agent_id}	Update an agent
DELETE	/v1/agents/{agent_id}	Delete an agent

Create agent shape

{
  "name": "Receptionist",
  "language": "en",
  "voice": "default",
  "server_url": "https://example.com/orbitali/webhook",
  "prompt": {
    "type": "static",
    "text": "You are a helpful receptionist."
  }
}

Tool configuration

Tools are attached to agents and delivered to the realtime model as callable functions.

{
  "name": "lookup_customer",
  "description": "Find a customer by phone number.",
  "parameters": {
    "type": "object",
    "properties": {
      "phone": { "type": "string" }
    },
    "required": ["phone"]
  }
}