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

# API Overview

> Orova REST API reference

## Base URL

```
https://app.orova.ai/api
```

All API endpoints are prefixed with `/api`.

## Authentication

All API requests require an API key in the `x-api-key` header. Generate one from the [Orova dashboard](https://app.orova.ai).

```bash theme={null}
curl https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY"
```

See [Authentication](/api-reference/authentication) for details.

## Response format

All responses are JSON. Successful responses return the data directly. Errors return:

```json theme={null}
{
  "statusCode": 400,
  "message": "Error description",
  "error": "Bad Request"
}
```

## Common status codes

| Code  | Description                               |
| ----- | ----------------------------------------- |
| `200` | Success                                   |
| `201` | Created                                   |
| `400` | Bad request — check your parameters       |
| `401` | Unauthorized — invalid or missing API key |
| `402` | Payment required — insufficient credits   |
| `403` | Forbidden — no access to this resource    |
| `404` | Not found                                 |
| `500` | Server error                              |

## Pagination

List endpoints support pagination:

| Parameter | Default | Description                             |
| --------- | ------- | --------------------------------------- |
| `page`    | `1`     | Page number                             |
| `limit`   | `10`    | Items per page (max varies by endpoint) |

## Rate limits

API requests are not currently rate-limited, but we recommend keeping requests under 100/minute per API key.