API Documentation

High-level endpoint map for Veil. Dashboard endpoints require authentication. Public endpoints are limited to status, OAuth entry points and static site features.

Public endpoints

Method	Endpoint	Purpose
GET	`/api/public/status`	Public uptime/version snapshot used by the status page.
GET	`/api/public/invite-analytics`	Aggregated invite click totals for the public status page.
GET	`/invite`	Records a source tag and redirects to Discord OAuth bot authorization.
GET	`/sitemap.xml`	SEO sitemap for public pages.

Authenticated dashboard endpoints

Module	Examples	Notes
Config	`/api/config/:guildId`, `/api/config/:guildId/preset`	Load, save and apply server configuration presets.
Dashboard	`/api/dashboard/home`, `/api/healthcheck`, `/api/metrics/commands`	Home widgets, server health and command analytics.
Translations	`/api/translations/status`, `/api/translations/entries`, `/api/translations/key`	Global translation editor. Write operations require owner access.
Tickets	`/api/tickets/stats`, `/api/tickets/transcripts`, `/api/tickets/notes`	Ticket workflow, archive, notes and canned responses.
Music	`/api/music/status`, `/api/music/action`, `/api/music/playlists`	Live queue, controls and favorite playlists.
Logs	`/api/logs/view`, `/api/logs/export.csv`, `/api/logs/retention/run`	Discord log viewer, CSV export and retention cleanup.
Owner	`/api/owner/premium`, `/api/owner/presence`, `/api/owner/bot-identity/:guildId/preset`	Owner-only premium, presence and per-server bot identity tools.