Authentication & Headers

UMVA AI API Authentication

All UMVA AI API requests require authentication via a Bearer token in the Authorization header. You can generate dedicated AI API keys from your UMVA dashboard.

AI API Keys (umva_ai_ prefix): These are specialized keys used for LLM completions and usage stats only. They can be generated from the dashboard under AI settings and revoked independently from Sanctum tokens.

Request Headers:

HeaderValueRequired
AuthorizationBearer umva_ai_YOUR_KEYYES
Content-Typeapplication/jsonYES
User-Agentumva-ai-editor/1.0Recommended
X-Request-IdUUIDRecommended (for tracing)

Editor Auth Flow (OAuth-like): The IDE uses a browser-based token exchange. Opening https://umva.net/account?redirect=umva-editor://callback redirects the browser to authorize the editor with no manual copy-pasting.