API keys
Create keys to use the sokko CLI and reach your account from your own scripts.
An API key lets the sokko CLI and your own scripts act on your account without a password. Each key is tied to your organization and your role, so it can only do what you can do.
Create a key
Open API Keys
In the dashboard, go to Settings → API Keys. You need to be an owner or admin.
Create and copy it
Give the key a name and create it. Copy the value now — it is shown once and cannot be retrieved later.
Use it
Sign the CLI in with it: sokko login, then paste the key. Or set
SOKKO_API_KEY in your environment.
Keys start with sk_live_ (or sk_test_ in test mode).
Use a key
sokko login --key sk_live_xxx
# or, for a single command / CI
SOKKO_API_KEY=sk_live_xxx sokko instances lsIf you call the API directly, send the key as a bearer token:
curl -H "Authorization: Bearer sk_live_xxx" https://sokko.ai/api/meKeep keys safe
- A key carries your access. Treat it like a password.
- Do not commit keys to a repo or paste them into chat.
- If a key leaks, delete it in Settings → API Keys and create a new one. Deleting a key stops it working immediately.
A key can only act inside the organizations you actually belong to, in the role you hold there. Losing access to an org means the key loses it too.