Create a key
- Sign in and open Settings → Integrations.
- Select Create key and give it a name that identifies the tool.
- Choose your company, all its projects or a specific list, and the permissions it needs.
- Choose an expiration, then select Create key.
- Copy the secret when it appears. Store it in your tool’s secret settings.
The full secret is shown only once. VoiceStudio stores its hash. If you lose it, revoke the old key and create a replacement.
Make a request
Set VOICESTUDIO_API_KEY in your environment or secret manager. Send it in the x-api-key header:
You can also use Authorization: Bearer YOUR_KEY instead of x-api-key. Send one credential header per request.
Change or revoke access
Review the key’s permissions, last-used date and expiration on the integrations page. To change access, revoke the key and create a replacement with the new permissions. Revocation prevents subsequent requests.
A key belongs to the account that created it. Removing that account’s company access, suspending it, or changing its review role can stop the key from working.
Keep keys out of browser code, source control and conversations. Use OAuth for
an assistant whenever it supports it.
