<!-- source: https://modelux.ai/docs/api/management -->

> REST endpoints for managing Modelux resources.

# Management API overview

The management API lets you do everything the dashboard does: create
projects, edit routing configs, rotate credentials, fetch analytics, set
budgets.

Base URL: `https://api.modelux.ai/manage/v1`

Authenticate with a management API key (`mlx_mk_...`), not a project key.

## Resources

| Resource | Reference |
|---|---|
| [Projects](/docs/api/management-projects) | List, create, get, update, delete |
| [Routing configs](/docs/api/management-routing) | CRUD + versions, test, restore |
| [Providers](/docs/api/management-providers) | CRUD + health, credential rotation |
| [Budgets](/docs/api/management-budgets) | CRUD + alerts, events, reset |
| [Analytics & logs](/docs/api/management-analytics) | Reports, decisions, logs, traces, replay |
| [Webhooks](/docs/api/management-webhooks) | Endpoints, deliveries, event types |
| API keys | List, create, revoke |
| Simulations | Create, list, results, promote, estimate |
| Audit log | List, get |
| Org & members | Update org, invite, list, role updates |

## OpenAPI spec

The full OpenAPI spec is available at:

```
https://api.modelux.ai/manage/v1/openapi.yaml
```

Use it to generate clients in any language or import into Postman / Insomnia.

## MCP tools

Every management endpoint has a corresponding MCP tool. See [MCP setup](/docs/guides/mcp-setup)
to connect Claude Code or another MCP client.

## Idempotency

All mutating endpoints accept an `Idempotency-Key` header. Same key + same
body within 24h returns the cached response. Ideal for retries.

## Pagination

List endpoints return cursor-paginated responses:

```json
{
  "data": [...],
  "next_cursor": "opaque_cursor_or_null",
  "has_more": true
}
```
