API Overview

Complete reference for the Discloud REST API: authentication, endpoints, and resource groups.

🌐 Base URL

All requests point to:

https://api.discloud.app/v2

---

🔑 Authentication

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

api-token: YOUR_TOKEN_HERE

See Authentication to learn how to obtain and protect your token.

---

⚡ Quick Start

1

Get your API token from the Dashboard.

2

Make your first request to confirm the token works:

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.

Never expose your token in public code or Git repositories. Store it in environment variables. See Authentication for security best practices.