> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Authenticate API requests and MCP clients with scoped credentials.

# Authentication

Use an API key in the `x-api-key` header or as an `Authorization: Bearer` credential. Remote MCP clients can also sign in through OAuth. OAuth access tokens are valid for the MCP resource only; use an API key for REST calls.

## Create a scoped key

Open [Integrations](https://app.voicecheap.ai/page-api), create a key, and select its permissions and optional expiration. The full key is shown once. Keep it in your secret store. You can rename it, change its permissions or expiration, or revoke it later.

## Permissions

Each action declares its required permissions in the [action catalog](https://api-docs.voicecheap.ai/docs/api-reference/actions.md). An action can require several permissions. Reading does not grant permission to create, modify, or delete. Existing keys without explicit permissions retain only their earlier project and transcription access; edit or replace them to enable new features.

| Area | Read | Write or delete |
| - | - | - |
| Account | `account:read` | — |
| Usage | `usage:read` | — |
| Settings | `settings:read` | `settings:write` |
| Team | `team:read` | `team:write` |
| Projects | `projects:read` | `projects:write`, `projects:delete` |
| Translation | — | `translations:write` |
| Transcription | `transcription:read` | `transcription:write` |
| Subtitles | `subtitles:read` | `subtitles:write` |
| Text to speech | `tts:read` | `tts:write` |
| Voices | `voices:read` | `voices:write` |
| Images | `images:read` | `images:write` |
| Thumbnails | `thumbnails:read` | `thumbnails:write` |
| Folders | `folders:read` | `folders:write` |
| Glossary | `glossary:read` | `glossary:write` |
| Webhooks | `webhooks:read` | `webhooks:write` |
| Publishing | `publishing:read` | `publishing:write` |

Permissions restrict a credential; they do not change your subscription, team role, project ownership, or available media credits. Administrative team changes remain restricted to the team owner.

## Header example

This discovery request lists only actions allowed by your key. Do not put an API key in browser code or a public repository.

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "x-api-key: vc_your-api-key"
```

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "Authorization: Bearer vc_your-api-key"
```

## OAuth connections

For compatible assistants, use the [remote MCP connection](https://api-docs.voicecheap.ai/docs/ai/model-context-protocol.md) and sign in to VoiceCheap. Review the permissions on the consent screen. You can revoke each connection in Integrations without deleting your API keys.

## Existing REST endpoints

Existing upload, translation, project, and transcript routes continue to accept API keys and now enforce the appropriate permission. See the [API reference](https://api-docs.voicecheap.ai/docs/api-reference/introduction.md) for their parameters and the [limits](https://api-docs.voicecheap.ai/docs/api-reference/limits.md) for usage rules.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.