Authentication
Every request is authenticated with an API key sent as a bearer token.
Sending the key
Authorization: Bearer ik_live_xxxxxxxxxxxxxxxxxxxxxxxxRequests 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
401from 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.