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

# Introduction

> Example section for showcasing API endpoints

# API Reference

Welcome to the Brilo API documentation. This guide will help you integrate with our API to manage calls and contacts.

## Authentication

All API requests require authentication using an API key. You can include your API key in the request headers:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

To get an API key, visit the [Developer Settings](https://dashboard.brilo.ai/settings/developer/api-keys) in your Brilo dashboard.

## Base URL

All API requests should be made to:

```bash theme={null}
https://api.brilo.ai/v1
```

## Versioning

Our API is versioned. The current version is `2025-03-02`. Include the version in your request headers:

```bash theme={null}
X-API-Version: 2025-03-02
```

## Rate Limiting

API requests are limited to 100 requests per minute per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.

## Error Handling

The API uses standard HTTP response codes:

* 200: Success
* 400: Bad Request
* 401: Unauthorized
* 403: Forbidden
* 404: Not Found
* 429: Too Many Requests
* 500: Internal Server Error

Error responses include a message explaining what went wrong:

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

## Pagination

List endpoints support pagination using the following query parameters:

* `skip`: Number of records to skip (default: 0)
* `take`: Number of records to return (default: 10)

The response includes metadata about the pagination:

```json theme={null}
{
  "data": [...],
  "totalRecords": 100,
  "currentPage": 1
}
```