Authentication

The Moviie API uses API keys to authenticate requests. API keys are tied to your organization, not to individual users.

Creating an API key

1. Open your dashboard and go to Settings → API Keys.
2. Click New key and give it a descriptive name (e.g., "Production server", "Staging").
3. Copy the key: it is shown only once.

Using your API key

Pass the key as a Bearer token in the Authorization header:

curl "https://api.moviie.ai/v1/videos" \
  -H "Authorization: Bearer mvi_your_api_key_here"

The key always starts with the mvi_ prefix so you can recognize it at a glance.

Security best practices

• Never expose your API key in frontend code. All calls to the Moviie API must go through your backend.
• Store your key in environment variables, not in source code.
• If a key is compromised, delete it immediately from Settings → API Keys and create a new one.

Error responses

If a key is missing or invalid, you will receive:

{ "error": "Unauthenticated" }

with HTTP status 401.