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

# Obter vozes disponíveis

> Recuperar todas as vozes disponíveis para configuração de assistentes 

Este endpoint retorna uma lista de todas as vozes disponíveis que podem ser usadas ao criar ou atualizar assistentes, com filtragem opcional por modo do assistente.

### Parâmetros de consulta

<ParamField query="mode" type="string">
  Filtrar vozes pelo modo do assistente. Opções: pipeline, multimodal
</ParamField>

### Campos de resposta

<ResponseField name="data" type="array">
  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      O identificador único da voz
    </ResponseField>

    <ResponseField name="name" type="string">
      O nome de exibição da voz
    </ResponseField>

    <ResponseField name="mode" type="string">
      O modo de assistente com o qual esta voz é compatível (pipeline ou multimodal)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 1,
      "name": "Sarah",
      "mode": "pipeline"
    },
    {
      "id": 2,
      "name": "Michael",
      "mode": "pipeline"
    },
    {
      "id": 3,
      "name": "Emma",
      "mode": "multimodal"
    },
    {
      "id": 4,
      "name": "David",
      "mode": "multimodal"
    },
    {
      "id": 5,
      "name": "Sophia",
      "mode": "pipeline"
    }
  ]
  ```
</ResponseExample>

### Observações

* Utilize o campo id ao criar ou atualizar assistentes.
* O campo mode indica com qual motor de assistente a voz é compatível.
* Filtre por mode para obter apenas vozes compatíveis com o tipo de assistente desejado.
* Se nenhum filtro de mode for fornecido, todas as vozes disponíveis são retornadas.
* Apenas vozes públicas ou pertencentes ao usuário autenticado são retornadas.