# POST /voices/:id/provider-mapping

**Resource:** [Voices](./voices.md)  
**Scopes:** `voices:write`  
**Write operation:** yes

Map a local voice (workspace or platform) to a provider-format voice ID so voice agent creation and provisioning use it instead of the fallback voice. Pass a namespaced voice_id (e.g. "11labs-Noah") from GET /voices/provider-catalog. Pass null to clear an existing mapping.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Local voice UUID (workspace or platform voice) |
| `retell_voice_id` | body | string|null | yes | Provider-format voice ID (e.g. "11labs-Noah"). Pass null to clear. |

## Request example

```bash
curl -X POST "https://ucqwijexmjctglmrxlej.supabase.co/functions/v1/api/v1/voices/voice-uuid/provider-mapping" \
  -H "Authorization: Bearer tp_live_..." \
  -H "Content-Type: application/json" \
  -d '{"retell_voice_id": "11labs-Noah"}'
```

## Response example

```json
{
  "data": {
    "id": "voice-uuid",
    "name": "Noah",
    "retell_voice_id": "11labs-Noah",
    "updated": true
  },
  "meta": {
    "credits_remaining": 4500
  }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`