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

# Introduction

> API reference documentation for Outbox AI

## Base URL

All API requests should be made to:

```
https://api.getoutbox.ai
```

## Authentication

All API endpoints are authenticated using an `Authorization` header with your API key. Note that you should pass the API key directly without the 'Bearer' prefix.

```bash theme={null}
Authorization: your-api-key-here
```

### API Key Types

There are two types of API keys:

* **Company API Key**: Used for company-level operations including:

  * Agent management (agents, files, integrations, tools)
  * Tool instances
  * Contacts and conversations
  * Call logs, chat logs, and transcripts
  * Company settings, staff, and phone numbers

* **Agency API Key**: Required for all agency-level operations (`/agency/*` endpoints) including:
  * Agency settings management
  * Managing companies under your agency
  * Agency admin invitations
  * Agency phone number management

You can find your API keys in your dashboard settings. Make sure to use the correct API key type for the endpoints you're accessing.

### Example Request

```bash theme={null}
curl -X GET https://api.getoutbox.ai/agent/list \
  -H "Authorization: your-company-api-key-here" \
  -H "Content-Type: application/json"
```

```bash theme={null}
curl -X GET https://api.getoutbox.ai/agency \
  -H "Authorization: your-agency-api-key-here" \
  -H "Content-Type: application/json"
```