Authentication

Every request is authenticated with an API key sent as a bearer token.

Sending the key

header
Authorization: Bearer ik_live_xxxxxxxxxxxxxxxxxxxxxxxx

Requests without a valid key return 401.

Key format

Live keys start with ik_live_. Each key is shown once, when it is created. We store only a SHA-256 hash of it, so a lost key cannot be recovered; create a new one and revoke the old one.

Managing keys

  • Create keys in the console under API keys. Give each one a name that says where it runs.
  • Use one key per service, so you can revoke one without touching the others.
  • Revoking a key takes effect immediately. Requests with that key return 401 from then on.
  • The console lists each key by its prefix and when it was last used.

Keeping keys safe

  • Keep keys in environment variables or a secret manager, never in source control.
  • Never send a key to a browser. Proxy requests through your backend.
  • If a key leaks, revoke it first and rotate second.

Test and live traffic are billed the same way. There is no sandbox environment yet.