Base URL
All endpoints live under https://api.chattler.ai/v1. Only HTTPS is served.
Authentication
Every request needs an API key in the Authorization header with the Bearer scheme. The key is created in the Chattler app; see Get your API key.
Keys are bound to one agent and carry a permission: read-only for the two GET endpoints, full for those plus the two POST chat endpoints.
Conventions
- Request and response bodies are JSON (
Content-Type: application/json), except the streaming endpoint, which answers text/event-stream.
- Both chat endpoints require an
Idempotency-Key header, 1-255 characters, unique per logical request. See Idempotency.
- Every response carries
X-Request-ID plus the rate-limit headers X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. See Rate limits.
- Every failure is
{"error": {"code", "message", "request_id"}}. See Errors.
- Lists are
{"data": [...], "next_cursor": "..." | null}; limit is 1-100, default 20.
- Timestamps are ISO-8601 in UTC. Filters accept timezone-aware or naive values (naive is read as UTC);
date_to is exclusive.
Try it in the playground
The endpoint pages have a playground. Paste a real key as the bearer token and use the agent id the key belongs to; requests go straight to https://api.chattler.ai and are billed like any other call.
Do not paste a full key into a shared screen or recording. Rotate it in the app if you did.
