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

# Introduction

> Run AI agents on real phones, or drive a phone yourself, with the Lusor API.

Lusor gives AI agents real phones. The phones in your workspace are your own phones, such as your iPhone or Android phone, and Lusor Phones, the cloud phones Lusor runs for you.

You can use the API in two ways:

> [card] [Send tasks to an agent](https://docs.lusor.ai/agents/send-a-turn.md)
>
> Describe a task in plain language. A Lusor agent operates the phone until the task is done and returns the result.

> [card] [Control a phone directly](https://docs.lusor.ai/phones/direct-control.md)
>
> Drive the phone yourself with deterministic actions: read the screen, tap, type, swipe and launch apps.

## Your first request

Create an API key in the [Lusor app](https://app.lusor.ai) under **Settings → API Keys**, then list the phones in your workspace:

```bash cURL theme={null}
curl https://api.lusor.ai/v1/devices \
  -H "X-Api-Key: $LUSOR_API_KEY"
```

```python Python theme={null}
import os, requests

r = requests.get(
    "https://api.lusor.ai/v1/devices",
    headers={"X-Api-Key": os.environ["LUSOR_API_KEY"]},
)
print(r.json())
```

```javascript Node.js theme={null}
const res = await fetch("https://api.lusor.ai/v1/devices", {
  headers: { "X-Api-Key": process.env.LUSOR_API_KEY },
});
console.log(await res.json());
```

The response lists each phone with its `id` and whether it is `connected`. The [Quickstart](https://docs.lusor.ai/quickstart.md) takes it from there to your first agent task.

## Base URL

```
https://api.lusor.ai
```

All endpoints are versioned under `/v1`. Requests and responses are JSON unless an endpoint says otherwise. The screenshot endpoint, for example, returns PNG bytes.

## Explore the docs

> [card] [Get started](https://docs.lusor.ai/quickstart.md)
>
> Create an API key, send your first task, and learn the core concepts.

> [card] [Agents & sessions](https://docs.lusor.ai/agents/create-an-agent.md)
>
> Create agents, send turns, follow sessions, and answer the agent's questions.

> [card] [Phones](https://docs.lusor.ai/phones/overview.md)
>
> The phones in your workspace, and how to control one directly.

> [card] [Billing and limits](https://docs.lusor.ai/billing/credits-and-minutes.md)
>
> Credits, Lusor Phone minutes, errors and rate limits.

> [card] [API reference](https://docs.lusor.ai/api-reference/introduction.md)
>
> Every endpoint, with an interactive playground.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.