Manage API keys

By issuing an API key, you can call the mocoVoice API from external systems and programs. An API key is an authentication credential shared by your team. Give it only to necessary integrations, and delete it when you no longer need it.

Open the API key management page

For organization accounts, open Team Settings, then go to Integrations and select API Integrations. Click Open API key management page.

For personal accounts, go to About you and open API Integrations.

Important

Only users with the Admin role can use and manage API keys. Editor, Submitter, and Viewer roles cannot use this feature.

Create an API key

1. Click Create API key.
2. Enter a name that identifies the integration. For example: CRM integration, Batch processing
3. Click Create.

After you create it, the API key is added to the list. You can change the permissions using the edit icon in the list if necessary.

Copy and store securely

Click the Copy icon in the list to copy the API key to your clipboard. The screen shows a sample like moco_1234••••��•••abcd. Do not paste the actual key into chats, emails, or documents.

Save the copied key in a restricted location, such as the secret management feature or environment variables of the integrated system. Set the API key in the request header specified in the API documentation to authenticate when calling the mocoVoice API.

MOCOVOICE_API_KEY="moco_1234••••••••abcd"

Teams that use a review step

When Add a review step before sharing is on, transcripts started through the API also wait for review. Until review is complete, they do not appear in the standard transcript list or detail API, and external integrations such as webhooks do not run.

Use the dedicated endpoint to check only the approval status:

GET /api/v1/transcriptions/{transcription_id}/approval-status

{
  "approval_status": "PENDING_APPROVAL",
  "approval_requested_at": "2026-07-20T15:00:00+09:00",
  "approved_at": null,
  "rejection_reason": null
}

approval_status is one of DRAFT (in progress), PENDING_APPROVAL (waiting for review), APPROVED (shared), or REJECTED (changes requested).

The response format of existing transcript APIs does not change. Existing teams that do not use the review step do not need to change their integrations.

Delete an API key

Delete an API key if you stop an integration, suspect the key has leaked, or if the user changes.

1. Find the target API key in the list.
2. Click the delete icon on the right side.
3. On the confirmation screen, click Delete API key.

The deleted API key will no longer work. If you want to continue the same integration, create a new API key and update the settings on the integrated system.