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

# API keys & quota

> Manage API keys and inspect usage limits for your tenant.

# API keys & quota

These endpoints apply to your **tenant** using API key authentication.

## API keys

Prefix: `/keys`

| Method   | Path             | Description                                 |
| -------- | ---------------- | ------------------------------------------- |
| `POST`   | `/keys`          | Create a key (raw secret returned **once**) |
| `GET`    | `/keys`          | List keys (prefixes and metadata only)      |
| `DELETE` | `/keys/{key_id}` | Revoke a key                                |

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.trygroundai.com/keys \
    -H "Authorization: Bearer gnd_owner_key" \
    -H "Content-Type: application/json" \
    -d '{"name":"CI"}'
  ```
</RequestExample>

Store new secrets immediately; they cannot be retrieved again.

## Quota

```
GET /quota
```

Returns **limit** configuration for your tenant (rate limits / caps as configured for your plan).

```
GET /quota/usage
```

Returns **current usage** against those limits (rolling windows).

<RequestExample>
  ```bash theme={null}
  curl https://api.trygroundai.com/quota/usage \
    -H "Authorization: Bearer gnd_your_api_key"
  ```
</RequestExample>

Quota **values** are part of your subscription or account setup. If you need a commercial change to limits, contact [ali@trygroundai.com](mailto:ali@trygroundai.com).