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

# API reference

> The stable public contracts between MudraID, the SDK, and the middleware.

This reference covers the **stable public contracts**. These are the endpoints the Python SDK and the FastAPI middleware depend on, and the ones you may call directly. They don't change without a deprecation window.

The endpoint pages under "Public Contracts" are generated from `openapi.yaml`.

## What's in the public contract

| Endpoint                                          | Used by                                |
| ------------------------------------------------- | -------------------------------------- |
| `POST /api/v1/auth/token`                         | SDK — trade credentials for a JWT      |
| `POST /api/v1/auth/agents/me/platforms`           | SDK — bootstrap the agent's platforms  |
| `GET /.well-known/jwks.json`                      | Middleware — fetch public signing keys |
| `GET /api/v1/platforms/{platform_id}/scopes.yaml` | Middleware — fetch the scope file      |

The JWT claim shape and the `mudraid_scopes.yaml` schema are part of the contract too.

## Server

* Production: `https://api.mudraid.ai`

## Related

* [Versioning and deprecation](/api-reference/versioning)