> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tazolabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Endpoints, authentication, and conventions for the Tazo API v1.

## Base URL

```text theme={null}
https://api.tazolabs.com
```

## Endpoints

| Method | Path | Auth | Purpose |
| - | - | - | - |
| `POST` | `/v1/decisions` | API key or access token | Send audio and questions, get typed answers. |
| `GET` | `/v1/models` | API key or access token | List models and capabilities. |
| `POST` | `/v1/api-keys` | Access token | Create an API key. |
| `GET` | `/v1/api-keys` | Access token | List your API keys. |
| `DELETE` | `/v1/api-keys/{key_id}` | Access token | Revoke an API key. |
| `GET` | `/healthz` | None | Check readiness. |

## Conventions

* **Auth:** `Authorization: Bearer <credential>`. See [Authentication](/authentication.md).
* **Errors:** `{"error": {"code", "message", "retryable"}}`. See [Errors](/guides/errors.md).
* **Caching:** key management responses send `Cache-Control: no-store`, including errors.
* **Browsers:** cross-origin requests are allowed only from configured origins.
  Browsers can read the `X-Tazo-Request-Id` response header.
* **Rate limits:** not enforced yet.

## OpenAPI

The specification is available as [`openapi.yaml`](/api-reference/openapi.yaml)
for client generation and tooling.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.