Embed your agent inside any app — your mobile app, your bespoke web app, your internal tooling — by talking to it via the REST API.
What you need
- A team API key (Team settings → API Keys)
- The agent ID you want to message
Send a message
POST https://chatzuri.com/api/v1/agents/{agentId}/chat
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"message": "Where's my order?",
"user_id": "customer-12345"
}The response contains the agent's reply, plus metadata (conversation ID, any actions called, tokens used).
Streaming responses
For real-time UI, use streaming so each token arrives as it's generated:
POST https://chatzuri.com/api/v1/agents/{agentId}/chat
Authorization: Bearer YOUR_API_KEY
Accept: text/event-stream
Content-Type: application/json
{
"message": "Tell me about your pricing",
"user_id": "customer-12345",
"stream": true
}See the streaming docs for full SDK examples in JavaScript, Python, and PHP.
Maintaining a conversation
Pass the same user_id across messages and Chatzuri threads them into a single conversation. The agent's memory works exactly as it does on any other channel.
Tip
For end-to-end developer documentation, the full reference lives at /docs. The guides version (this one) gives you the picture; the docs give you every endpoint, every payload, every error code.
Rate limits and quotas
Each plan has a per-team rate limit and a monthly message quota. Limits are documented on your Team settings → Plans page.