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

# API overview

> Automate Ravion projects, environments, pipelines, deployments, and infrastructure workflows from your own tools with the Ravion REST API.

The Ravion API lets you automate the same cloud workflow primitives you use in the dashboard.

Use it to manage projects, environments, pipelines, deployments, service accounts, API keys, code sources, Terraform resources, and infrastructure events.

## Base URL

Send API requests to:

```text theme={null}
https://api.ravion.com
```

The OpenAPI specification is available at:

```text theme={null}
https://api.ravion.com/openapi.yaml
```

## Authentication

The API uses bearer authentication.

Include your token in the `Authorization` header:

```http theme={null}
Authorization: Bearer <token>
```

Use service accounts and API keys for automation that should not depend on a person's dashboard session.

## Pagination

List endpoints can return paginated responses.

Use the `limit` query parameter to control page size. Use the returned cursor, such as `nextCursor`, to request the next page.

## Errors

Error responses include a machine-readable code and a human-readable message. They can also include a `requestId` that helps Ravion trace the request.

## Endpoint reference

Use the generated endpoint pages in this section for request parameters, response schemas, and example payloads.