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

# API keys

> Create, list, and revoke scoped MESH API keys.

MESH API keys start with `mesh_live_` or `mesh_test_`. Operators can create separate keys for
projects, clients, and team members while drawing from one account balance.

```bash theme={null}
curl https://api.meshrouter.app/v1/api-keys \
  -H "Authorization: Bearer $MESH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production app",
    "scopes": ["chat", "usage"],
    "limits": {
      "requestsPerMinute": 120,
      "monthlyRequestLimit": 10000,
      "monthlyUsdLimit": 100
    }
  }'
```

The secret is returned once. Store only hashed keys server-side, update budgets with
`PATCH /v1/api-keys/{id}/limits`, and revoke leaked keys with `DELETE /v1/api-keys/{id}`.