> For the complete documentation index, see [llms.txt](https://docs.discloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discloud.com/en/api-and-integrations/api-overview.md).

# API Overview

### 🌐 Base URL

All requests point to:

```
https://api.discloud.app/v2
```

***

### 🔑 Authentication

Every request requires the `api-token` header with your personal token:

```bash
api-token: YOUR_TOKEN_HERE
```

See [Authentication](#authentication) to learn how to obtain and protect your token.

***

### ⚡ Quick Start

{% stepper %}
{% step %}
Get your API token from the Dashboard.
{% endstep %}

{% step %}
Make your first request to confirm the token works:

```bash
curl -X GET \
  -H "api-token: YOUR_TOKEN_HERE" \
  https://api.discloud.app/v2/user
```

A `200 OK` response with your user data confirms authentication is working.
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
Never expose your token in public code or Git repositories. Store it in environment variables. See [Authentication](#authentication) for security best practices.
{% endhint %}