Authentication

All API requests require authentication using an API key. Include your key in the Authorization header using the Bearer scheme.

Using Your API Key

Add the Authorization header to every request:

curl "https://api.emfas.ai/v1/products" \
  -H "Authorization: Bearer YOUR_API_KEY"

Getting an API Key

1. Log in to your Emfas workspace
2. Open Settings (gear icon in the top-right)
3. Click the API tab
4. Click + to create a new key, give it a reference name, and click Generate key
5. Copy the key immediately — it is only shown once

Authentication Errors

If authentication fails, you'll receive a 401 Unauthorized response:

{
  "error": "Unauthorized - missing or invalid authentication"
}

Common causes:

• Missing Authorization header
• Invalid or revoked API key
• Malformed header (missing "Bearer " prefix)