API Keys

API keys authenticate the API Channel — programmatic access to the organization's data (agents, calls, analytics, knowledge, webhooks) at https://api.diska.ai/v1, restrictable with scopes.

Create a key

1. Go to Settings > API Keys.
2. Click New key.
3. Provide a name and an optional description.
4. Pick the scopes (no selection = full access) and, optionally, an expiry date.
5. Save the full key: it is shown only once.

Using the key

curl https://api.diska.ai/v1/me \
  -H "Authorization: Bearer dsk_…"

The full endpoint list is in API Channel. The keys page shows each key's last use, to help spot forgotten keys.

Revoke

You can revoke a key at any time. Endpoints using that key will fail immediately.

Security

• store keys in environment variables;
• never expose keys in frontend code;
• rotate keys periodically.