---
search:
  tags:
    - AI voices
    - POST
seo:
  description: >-
    Remove a single voice from the set donors can pick from: hide a… Reference
    for the POST /ai-voices/{voiceId}/disable endpoint in the TipPage Developer
    API.
sidebar:
  label: Disable one voice
  badge: POST
title: Disable one voice
type: openapi-operation
---
Remove a single voice from the set donors can pick from: hide a TipPage voice, or drop another streamer's voice you had added (whether or not it is still published). Your own cloned voices can't be disabled, only deleted from the dashboard - `400 own_voice`. There is no last-voice rule; turn the whole feature off with `POST /ai-voices/disable`. Requires `ai_voices:manage`. TipPage+: answers `404` unless AI voices are enabled for your account.

`POST /ai-voices/{voiceId}/disable`

**Responses**

- `200` — The voice is disabled.
- `400` — That is one of your own cloned voices - delete it from the dashboard instead.
- `401` — Missing or invalid credential (\`missing\_api\_key\` / \`invalid\_api\_key\`, or \`invalid\_token\` for an expired/revoked OAuth access token).
- `403` — The key lacks the required scope (\`missing\_scope\`).
- `404` — No such resource.
- `429` — Rate limit exceeded - check the \`RateLimit-\*\` headers.

Response example, 200:

```json
{
  "success": true,
  "id": "string",
  "enabled": false,
  "enabled_voices": 0
}
```
