Authentication

The Launchverse API uses bearer tokens for authentication.

API Tokens

Mint an API token from Dashboard → API Tokens. Tokens are prefixed lvse_ and are shown once at creation time.

Authorization: Bearer lvse_<token>

Token Scopes

Three scopes are available:

1. read — Read access to projects, deployments, domains, and resources.
2. write — Read + write access. Implies read.
3. deploy — Read + deploy access. Implies read.

Authentication Errors

Failed authentication returns 401 with:

{ "error": "...", "code": "UNAUTHORIZED" }

A missing scope returns 403 with code: "FORBIDDEN".

Public Endpoint

GET /api/v1/status is public and needs no token.