Authentication

​

Authorization header

Authorization: Bearer mage_sk_...

curl --url https://api.mage.space/v1/account \
  --header "Authorization: Bearer $MAGE_API_KEY"

​

Keys

• A key starts with mage_sk_ and is shown once, when it is created. Mage stores only a hash of it, so a lost key cannot be recovered: create a new one and revoke the old one.
• An account may hold up to 10 active keys. Name each one for the service or environment that uses it, so revoking one does not take the others down.
• Revoking a key in Settings → API takes effect immediately. Generations already running finish, but the key can no longer submit, read, or cancel requests.
• Settings → API shows when each key was last used.

​

Authentication errors

{
  "error": {
    "code": "unauthorized",
    "message": "The API key is invalid or has been revoked."
  }
}