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

# Delete a Voice

> Permanently deletes a custom voice from your workspace using its voice ID.

## Overview

Use this endpoint to remove a custom voice you no longer need. You can delete only voices you created, and you must use an API key from the workspace that owns the voice.
This is a permanent action, so make sure the voice is not used by any active workflows before deleting it.

## Path Parameter

* `voice_id`: The numeric ID of the voice to delete (for example, `9013`).

## Example Request

```bash theme={null}
curl -X DELETE "https://client.camb.ai/apis/delete-voice/9013" \
  -H "x-api-key: YOUR_API_KEY"
```

## Example Response

```json theme={null}
{
  "status": "ok"
}
```


## OpenAPI

````yaml delete /delete-voice/{voice_id}
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://client.camb.ai/apis
security: []
paths:
  /delete-voice/{voice_id}:
    delete:
      tags:
        - Apis
      summary: Delete Voice
      operationId: delete_voice_delete_voice__voice_id__delete
      parameters:
        - name: voice_id
          in: path
          required: true
          schema:
            type: integer
            exclusiveMinimum: 0
            title: Voice Id
            description: The unique identifier of the custom voice to delete.
            default: 147320
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              example:
                status: ok
              schema:
                type: object
                description: Deletion confirmation payload for the requested voice.
                properties:
                  status:
                    type: string
                    enum:
                      - ok
                    description: Indicates successful deletion.
                required:
                  - status
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        The `x-api-key` is a custom header required for authenticating requests
        to our API. Include this header in your request with the appropriate API
        key value to securely access our endpoints. You can find your API key(s)
        in the 'API' section of our studio website.

````