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

# Eliminar proyecto

> Eliminar permanentemente un proyecto de traducción

# Eliminar proyecto

Eliminar permanentemente un proyecto de traducción y sus activos asociados.

Esta limpieza también elimina cualquier archivo de ejemplo de vista previa de clonación de voz almacenado que se haya generado para el proyecto.

Si algunos archivos internos generados o registros de segmentos ya se eliminaron antes de que se complete la eliminación, la limpieza continúa en modo de mejor esfuerzo y aún finaliza la eliminación del proyecto.

<Warning>
  Esta operación es irreversible. El proyecto, los trabajos, los activos multimedia generados y los archivos de ejemplo de vista previa de voz almacenados se eliminarán.
</Warning>

## Solicitud

### Encabezados

<ParamField header="x-api-key" type="string" required>
  Su clave API VoiceCheap. Obtenga una en [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).
</ParamField>

### Parámetros de ruta

<ParamField path="projectId" type="string" required>
  El identificador único del proyecto de traducción a eliminar.
</ParamField>

## Respuesta

<ResponseField name="success" type="boolean" required>
  Indica que la operación de eliminación se completó correctamente.
</ResponseField>

<ResponseField name="message" type="string" required>
  Mensaje de confirmación legible por humanos.
</ResponseField>

<ResponseField name="projectId" type="string" required>
  El ID del proyecto eliminado.
</ResponseField>

## Ejemplos

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

## Errores

| Estado | Código                | Descripción                                                |
| ------ | --------------------- | ---------------------------------------------------------- |
| 401    | `INVALID_API_KEY`     | La clave API proporcionada no es válida                    |
| 403    | `FORBIDDEN`           | No tiene permiso para eliminar este proyecto               |
| 404    | `PROJECT_NOT_FOUND`   | El proyecto especificado no existe                         |
| 429    | `RATE_LIMIT_EXCEEDED` | Demasiadas solicitudes (límite: 10 solicitudes por minuto) |
| 500    | `INTERNAL_ERROR`      | Error inesperado del servidor                              |