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

# Pylva API Overview

> Understand Pylva's SDK-facing API surface, authentication model, telemetry ingest endpoints, pricing APIs, and budget sync flow.

Pylva is SDK-first. Most teams should use the TypeScript or Python SDK instead of calling the API directly.

## Base URL

```txt theme={null}
https://api.pylva.com
```

Self-hosted deployments can use a different endpoint.

## Authentication

SDK-facing endpoints authenticate with a Pylva API key in `X-Pylva-Key`.

```bash theme={null}
curl https://api.pylva.com/api/v1/events \
  -H "X-Pylva-Key: $PYLVA_API_KEY"
```

Use Agent SDK keys for SDK ingest and Admin API keys only where pricing mutation is required.

## Public API pages

* [Submit telemetry events](events).
* [Manage custom pricing](custom-pricing).
* [Sync budget accumulators](budget-sync).

## OpenAPI status

Pylva does not publish an OpenAPI-generated reference in this first Mintlify setup. The current API pages are manually maintained. When an OpenAPI spec is added to the repo, Mintlify can generate interactive endpoint pages from it.