v51

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-02172186551.1 KB

Agents

Create a standalone agent

Create an agent without a sender. It is created disabled; connect a sender and enable it when you are ready for it to answer.

post/v1/agents

Request body

namestring required

provider'openai' | 'anthropic' | 'google' | 'mistral' | 'zavu' required

LLM provider for the AI agent.

modelstring required

systemPromptstring required

contextWindowMessagesinteger

includeContactMetadataboolean

triggerOnChannelsstring[]

triggerOnMessageTypesstring[]

maxTokensinteger

temperaturenumber

Example request

{
  "voice": {
    "greeting": "Hi, thanks for calling Acme. How can I help you today?",
    "greetings": {
      "es": "Hola, soy Atlas. Preguntame lo que quieras."
    },
    "language": "en",
    "model": "openai/gpt-4o",
    "ttsVoiceId": "aria",
    "transferPhoneNumber": "+14155551234"
  }
}

Response

Agent created.

Example response

{
  "agent": {
    "id": "agent_abc123",
    "senderId": "sender_12345",
    "name": "Customer Support Agent",
    "model": "gpt-4o-mini",
    "triggerOnChannels": [
      "sms",
      "whatsapp"
    ],
    "triggerOnMessageTypes": [
      "text"
    ],
    "voice": {
      "greeting": "Hi, thanks for calling Acme. How can I help you today?",
      "greetings": {
        "es": "Hola, soy Atlas. Preguntame lo que quieras."
      },
      "language": "en",
      "model": "openai/gpt-4o",
      "ttsVoiceId": "aria",
      "transferPhoneNumber": "+14155551234"
    }
  }
}