## What is Ravi?

Ravi gives AI agents isolated communication and credential surfaces: identities, email inboxes, phone numbers, contacts, API keys, webhooks, passwords, and secrets.

The important product boundary is simple:

- The backend API runs at `https://api.ravi.app`.
- The dashboard runs separately from this docs site.
- Public API docs live here on `docs.ravi.app`.
- Machine-readable API reference is published at `https://docs.ravi.app/openapi.json`.

## Start Here

| Goal | Read |
| --- | --- |
| Sign up and create an identity | [Sign Up](/getting-started/sign-up/) |
| Understand auth | [Authentication](/getting-started/authentication/) |
| See the API shape | [API Overview](/api/overview/) |
| Find endpoint groups | [API Endpoints](/api/endpoints/) |
| Use the OpenAPI contract | [API Reference](/api/reference/) |
| Use a first-party client | [SDK Overview](/sdk/overview/) |
| Use email | [Email](/core-concepts/email/) |
| Use phone and SMS | [Phone & SMS](/core-concepts/phone-and-sms/) |
| Store passwords and secrets | [Credential Vault](/core-concepts/credential-vault/) |
| Install the CLI | [Installation](/getting-started/installation/) |

## Core Concepts

An **Identity** is the scoped persona an agent operates as. Identity-scoped API keys and requests can only operate on the resources available to that identity.

An identity can own communication resources:

```text
Identity
├── Email inbox
├── Phone number
├── Contacts
├── Password entries
└── Secret entries
```

Ravi also supports management-level keys for account or workspace operations, plus identity-level keys for agent runtime work.

## Machine-Readable Docs

Use these text endpoints when handing Ravi docs to an agent:

```bash
curl https://docs.ravi.app/llms.txt
curl https://docs.ravi.app/llms-full.txt
```

`/llms.txt` is a compact index. `/llms-full.txt` includes the full markdown body for every public docs page.

Every docs HTML page also has a plain-text sibling. For example:

```text
https://docs.ravi.app/api/reference.txt
https://docs.ravi.app/sdk/typescript.txt
https://docs.ravi.app/sdk/python.txt
https://docs.ravi.app/core-concepts/identities.txt
```