Authentication

All API requests require authentication via an X-API-Key header. Generate API keys from your Dashboard → API Keys.

Header Format

Include the API key in every request:

Header

X-API-Key: art_live_your_api_key_here

Artos API keys are prefixed with art_live_ followed by a random string. Keys are only shown once when created — store them securely.

Key format

art_live_K7x9mN3pQ2vR8wY5zA4bC6dE1fG0hI

Shown once only

The full API key is shown once immediately after creation. Copy it and store it as an environment variable. If lost, delete and recreate the key.

If the API key is missing or invalid, the API returns a 401 response:

401 — Missing key

{ "success": false, "error": "Missing X-API-Key header" }

401 — Invalid key

{ "success": false, "error": "Invalid API key" }