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

# Beyond Presence REST API

> Manage avatars, agents, conversations, external APIs, and speech-to-video sessions with the Beyond Presence REST API and x-api-key auth.

The Beyond Presence API provides direct programmatic access to our platform, allowing you to build custom video agent experiences and integrate our technology into your applications.

## API Features

The API enables you to:

* **Manage avatars**: List available avatars and access avatar details
* **Control agents**: Create, configure, update, and delete video agents
* **Monitor conversations**: Access conversation metadata and transcripts
* **Configure integrations**: Set up external API connections and webhooks
* **Start speech-to-video sessions**: Initiate real-time speech-to-video sessions

Complete documentation for all REST endpoints is available in our [API reference](/api-reference).

For speech-to-video sessions, use our [LiveKit plugin](/integrations/voice-agents/livekit) rather than calling the session endpoints directly.

## Authentication

Generate API keys in your [Studio settings](https://bey.studio/settings/api-keys).
Include your key in the `x-api-key` header with all requests:

```sh theme={null}
curl "https://api.bey.dev/v1/avatars" \
  --header 'x-api-key: sk-your-api-key-here'
```

## Learn More

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/api-reference/agents/list-agents">
    Complete documentation for all API endpoints
  </Card>

  <Card title="API Errors" icon="triangle-exclamation" href="/concepts/api/errors">
    Understand API error responses and status codes
  </Card>

  <Card title="Quotas" icon="gauge-high" href="/production/concurrency">
    API concurrency and usage limits that apply to your plan
  </Card>
</CardGroup>


## Related topics

- [Glossary](/learn/glossary.md)
- [API Errors](/concepts/api/errors.md)
- [Speech-to-Video Quickstart](/get-started/quickstart/speech-to-video.md)
- [Beyond Presence Avatar Models](/concepts/avatars/index.md)
- [Choose Path](/get-started/choose-path.md)