Dariet API Reference

Base URL: /api · Auth: Authorization: Bearer <token> · Interactive docs: /docs

---

Quick Start

# 1. Get a token
curl -X POST /api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"your-password"}'

# 2. Create an agent
curl -X POST /api/agents \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"support-agent","prompt":"You are a helpful support agent."}'

# 3. Initiate an outbound call
curl -X POST /api/calls/outbound \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+919876543210","agent_name":"support-agent"}'

---

Sections

Section	What's in it
Authentication	Login, password reset, user management, API keys
Agents	Create and configure voice agents (providers, prompt, tools, webhooks)
Flow Nodes	Multi-node conversation flows with per-node prompts and transitions
Tools	Webhook tools the LLM can call during a conversation
Calls	Call history, outbound dialing, event traces, recordings
Settings	Telephony provider config and phone number → agent mapping
Webhooks	Outgoing call events + inbound telephony provider callbacks
Sidechat	Dashboard AI assistant endpoint

---

Auth Summary

Every request (except login and password reset) requires:

Authorization: Bearer <jwt_token>
Authorization: Bearer dk_...        ← API key for server-to-server

See Authentication for how to obtain tokens and manage API keys.

---

Common Patterns

Partial updates — all PATCH endpoints accept only the fields you want to change.

Pagination — list endpoints accept page and page_size query params. Response includes total.

UUIDs — all id fields are UUID strings.

Timestamps — all timestamps are ISO 8601 UTC (e.g. 2026-03-18T10:23:45).

Errors — non-2xx responses return { "detail": "message" }.