Creating and revoking API keys
How to create and revoke, per environment in the dashboard, the API keys your server uses to call the voicast API.
An API key lets your server call the voicast API (https://api.voicast.jp/v1). Keys are per environment: live keys start with vk_live_ and test keys with vk_test_.
Managing API keys requires the admin role or above. Other roles don't see API keys in the left menu.
Create an API key#
- Open the environment (live or test) where the key will be used.
- Under API keys in the left menu, press + Create API key.
- Enter a Name that tells you where the key is used (for example, Production server; up to 100 characters) and press Create.
- Copy the key that appears and store it somewhere safe.
The key is shown only once, when it's created. You can't see it again after closing. Next steps in the same dialog shows the command to install the Node.js SDK and the API URL.
- Keep API keys on your server only; never put them in a browser or app.
- The list shows the start of each key, when it was last used and when it was created.
See Getting started for the steps to your first call and the API reference for every endpoint.
Revoke an API key#
Revoke a key if it may have leaked or is no longer used.
- Press Revoke on the key in the API keys list.
- Press Revoke in the confirmation dialog.
Requests using a revoked key fail immediately. This can't be undone. To replace a key, create the new key and update your server first, then revoke the old one.
Using MCP#
MCP clients such as Claude don't need an API key to operate voicast; you sign in and allow access (MCP). You can revoke allowed apps in your account settings.