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

# API overview

> Base URL, authentication, and using the API reference

Use the **API reference** section in the sidebar to browse operations, request and response shapes, and try calls in the interactive playground.

<Warning>
  The COSMIC API layer is in public preview. Endpoint structure is expected to be mostly stable, but response fields, edge cases, and reliability are still subject to change.
</Warning>

## Base URL

API requests use this host:

```bash theme={null}
https://api.natecosmic.com
```

Paths in the reference (for example `/v1/me`) are appended to that base URL.

## Authentication

Send a valid access token in the `Authorization` header as a Bearer token:

```bash theme={null}
Authorization: Bearer <access_token>
```

Most `/v1/*` operations require authentication. OAuth app tokens are limited by the scopes you enable for the app. See [Access tokens](/concepts/access-token), [Scopes](/concepts/scopes), and [Authorization](/concepts/authorization).

## OpenAPI specification

Download the machine-readable API description (OpenAPI 3) to generate clients, validate requests, or import into your own tools:

* [OpenAPI document (JSON)](/openapi.json)