Skip to main content

Authentication

Every API call needs a bearer key.
  • Header: Authorization: Bearer <key>
  • No key → 401 missing_api_key
  • Not an abl_ key → 401 invalid_key_format
  • Unknown key → 401 invalid_key
  • Revoked key → 401 key_revoked
  • Expired key → 401 key_expired (the message gives the expiry time)
  • Account email not verified → 403 email_unverified
  • Account deleted → 403 account_deleted
  • Workspace member’s account removed or suspended → 403 member_inactive
A 401 or 403 is always about the key or its account, never about balance or request rate: those are 402 and 429. See Errors.
Never ship keys in client-side code. Call Refuseless from your server and keep keys in environment variables or a secret store.
Out of credits mid-request? A non-streamed call returns 402 insufficient_credits. A stream emits a {"error": {"code": "insufficient_credits"}} event and stops. Top up and retry — see Errors.