API Reference.
Macha exposes a versioned REST API for everything you can do in the dashboard. Build agents programmatically, query conversations, manage tools, all from your own backend.
Introduction
Getting Started
Make your first authenticated request against the Macha REST API in under five minutes.
Authentication
Generate API keys, choose the right scopes, and authenticate requests with Bearer tokens.
Errors
Every Macha API error returns a stable code your code can switch on. Reference for every code we emit.
Pagination
List endpoints page through results using opaque cursors. Reliable across inserts, no offset drift.
Idempotency
Send write requests safely. An Idempotency-Key header makes POST and PATCH retryable without duplicates.
Rate Limits
Every API key gets 1,000 requests per minute and 10,000 per hour. Headers expose what's left.
Versioning
The Macha API is versioned at /v1. What changes additively, what requires a new version, and how we deprecate.
Resources
© 2026 AGZ Technologies Private Limited