Skip to main content
POST
Create an agent

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create an agent that exists on its own, disabled and connected to no channel.

name
string
required
Maximum string length: 100
provider
enum<string>
required

LLM provider for the AI agent.

Available options:
openai,
anthropic,
google,
mistral,
zavu
model
string
required
systemPrompt
string
required
Maximum string length: 10000
apiKey
string

Your key for the model provider. Required for openai, anthropic, google and mistral, where a request without it is refused with 400; not used with zavu. Stored encrypted and never returned.

contextWindowMessages
integer
default:10
Required range: 1 <= x <= 50
includeContactMetadata
boolean
default:true
triggerOnChannels
string[]
triggerOnMessageTypes
string[]
maxTokens
integer
Required range: 1 <= x <= 4096
temperature
number
Required range: 0 <= x <= 2
voice
object

Voice Agent configuration on an AI agent. Controls how the agent behaves on inbound and outbound phone calls through Zavu's managed voice pipeline (speech recognition, the agent's LLM, and speech synthesis, with real-time interruption handling). Requires the Voice Agents feature to be enabled for your team.

Response

Created, disabled and connected to no channel.

agent
object
required

An AI agent. It answers on the addresses in channels.