API Key Scopes - Notifique

Each scope is a door on your key: dial, query, or control the session, open only what you need.

Each scope unlocks one type of Voice operation. Use only what your integration needs.

How to send the key

Recommended

Authorization: Bearer sk_live_your_key_here

Alternative

x-api-key: sk_live_your_key_here

The API Key belongs to one workspace. You cannot access another workspace with the same key.

voice:call, voice:read

voice:call, voice:read, voice:control

voice:read

voice:read (recording download)

An empty scope list on create = ADMIN access. Always restrict in production.

voice:call

Originate outbound calls. Requires ACTIVE number and balance or credits. Typical return: 202 with call id.

voice:read

List workspace calls, query detail and events (includeEvents), and download recording files.

voice:control

Actions on active session: speak, play, gather, transfer, record-start, record-stop, dtmf, hangup.

401: missing, invalid, or revoked key

Check Authorization: Bearer sk_... and that the key was not deleted in the dashboard.

402: insufficient balance or credits

Workspace blocked or no balance for dialing. Resolve in the dashboard.

403: missing scope

Verify scope for the operation (Missing scope: voice:call, etc.).

400: invalid or non-ACTIVE origin

from must be an ACTIVE workspace number (id or E.164).