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

# Overview

> Manage calls with Reddy's Call API endpoints for starting, stopping, and tagging calls.

## Conversations

Conversations are the primary unit for call management in Reddy. Each conversation is uniquely identified by the combination of:

* **Conversation ID**: A unique string identifier for the conversation
* **Agent Email**: The email address of the agent handling the call

This combination ensures that conversations remain isolated and properly attributed to the correct agent.

## Authentication

All Call Endpoints require authentication using a Bearer token in the Authorization header:

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

Contact your Reddy Support Manager to obtain API credentials.

## Error Handling

Call Endpoints can return errors in the following scenarios:

* **Invalid agent**: When the provided agent email doesn't match an active Reddy user
* **Conversation not found**: When the conversation lookup fails for the given conversation ID and agent combination
* **Invalid parameters**: When required parameters are missing or malformed

<Tip>
  Always validate that your agent email corresponds to an active user in your Reddy system before making API calls.
</Tip>