> ## 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.

# Excluir Projeto

> Excluir permanentemente um projeto de tradução

# Excluir Projeto

Excluir permanentemente um projeto de tradução e seus ativos associados.

Esta limpeza também remove quaisquer arquivos de exemplo de pré-visualização de clonagem de voz armazenados que foram gerados para o projeto.

Se alguns arquivos internos gerados ou registros de segmento já foram removidos antes da conclusão da exclusão, a limpeza continua no modo de melhor esforço e ainda finaliza a exclusão do projeto.

<Warning>
  Esta operação é irreversível. O projeto, trabalhos, ativos de mídia gerados e arquivos de exemplo de pré-visualização de voz armazenados serão excluídos.
</Warning>

## Solicitação

### Cabeçalhos

<ParamField header="x-api-key" type="string" required>
  Sua chave de API VoiceCheap. Obtenha uma em [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).
</ParamField>

### Parâmetros de Caminho

<ParamField path="projectId" type="string" required>
  O identificador único do projeto de tradução a ser excluído.
</ParamField>

## Resposta

<ResponseField name="success" type="boolean" required>
  Indica que a operação de exclusão foi concluída com sucesso.
</ResponseField>

<ResponseField name="message" type="string" required>
  Mensagem de confirmação legível por humanos.
</ResponseField>

<ResponseField name="projectId" type="string" required>
  O ID do projeto excluído.
</ResponseField>

## Exemplos

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.voicecheap.ai/v1/translate/abc123-def456-ghi789" \
    -H "x-api-key: vc_your-api-key"
  ```

  ```typescript TypeScript theme={null}
  interface DeleteProjectResponse {
    success: true;
    message: string;
    projectId: string;
  }

  async function deleteProject(projectId: string): Promise<DeleteProjectResponse> {
    const response = await fetch(
      `https://api.voicecheap.ai/v1/translate/${projectId}`,
      {
        method: 'DELETE',
        headers: {
          'x-api-key': 'vc_your-api-key',
        },
      },
    );

    if (!response.ok) {
      const error = await response.json();
      throw new Error(error.message || 'Failed to delete project');
    }

    return response.json();
  }

  // Usage
  deleteProject('abc123-def456-ghi789')
    .then((result) => console.log('Deleted:', result.projectId))
    .catch((error) => console.error('Error:', error));
  ```

  ```python Python theme={null}
  import requests

  project_id = 'abc123-def456-ghi789'
  headers = {'x-api-key': 'vc_your-api-key'}

  response = requests.delete(
      f'https://api.voicecheap.ai/v1/translate/{project_id}',
      headers=headers
  )

  if not response.ok:
      error = response.json()
      raise Exception(error.get('message', 'Failed to delete project'))

  result = response.json()
  print(f"Deleted: {result['projectId']}")
  ```

  ```php PHP theme={null}
  <?php
  $apiKey = 'vc_your-api-key';
  $projectId = 'abc123-def456-ghi789';

  $curl = curl_init();

  curl_setopt_array($curl, [
      CURLOPT_URL => "https://api.voicecheap.ai/v1/translate/{$projectId}",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'DELETE',
      CURLOPT_HTTPHEADER => [
          "x-api-key: {$apiKey}"
      ]
  ]);

  $response = curl_exec($curl);
  $result = json_decode($response, true);

  if (!isset($result['success'])) {
      $message = $result['message'] ?? 'Failed to delete project';
      throw new Exception($message);
  }

  echo "Deleted: " . $result['projectId'];
  ```
</CodeGroup>

## Erros

| Status | Código                | Descrição                                                |
| ------ | --------------------- | -------------------------------------------------------- |
| 401    | `INVALID_API_KEY`     | A chave de API fornecida é inválida                      |
| 403    | `FORBIDDEN`           | Você não tem permissão para excluir este projeto         |
| 404    | `PROJECT_NOT_FOUND`   | O projeto especificado não existe                        |
| 429    | `RATE_LIMIT_EXCEEDED` | Muitas solicitações (limite: 10 solicitações por minuto) |
| 500    | `INTERNAL_ERROR`      | Erro inesperado do servidor                              |