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

# API Overview

> The /v1 REST API.

The `/v1` API is authenticated with an API key sent as a bearer token:

```bash theme={null}
curl https://app.cruq.ai/v1/agents \
  -H "Authorization: Bearer cruq_sk_..."
```

Responses are JSON with snake\_case fields.

## Rate limits

Requests are rate limited per API key. When you exceed the limit the API returns
`429 Too Many Requests` with a `Retry-After` header (seconds). Back off and retry.

## Endpoints

### Agents & runs

* `GET /v1/agents`, `POST /v1/agents`
* `POST /v1/agents/{id}/versions`
* `GET /v1/agents/{id}/runs`
* `GET /v1/runs`, `GET /v1/runs/{id}`
* `GET /v1/tools`, `POST /v1/tools`

### Knowledge

* `GET /v1/knowledge`, `POST /v1/knowledge`, `DELETE /v1/knowledge/{kb}`
* `GET /v1/knowledge/{kb}/documents`, `POST /v1/knowledge/{kb}/documents`
* `POST /v1/knowledge/search`

### Memory

* `GET /v1/memory`, `POST /v1/memory`, `DELETE /v1/memory/{id}`
* `POST /v1/memory/search`

### Guardrails & prompts

* `GET /v1/guardrails`, `POST /v1/guardrails`, `DELETE /v1/guardrails/{name}`
* `GET /v1/prompts`, `POST /v1/prompts`, `DELETE /v1/prompts/{name}`