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

Los registros del proyecto siempre se eliminan. La eliminación de medios se realiza en modo de mejor esfuerzo: si un archivo almacenado no se puede eliminar, o ya se había eliminado antes de que se complete la eliminación, la limpieza lo registra, continúa y aún finaliza la eliminación del proyecto. Por lo tanto, ocasionalmente un archivo generado puede permanecer en el almacenamiento.

> [!WARNING]
>
> Esta operación es irreversible. El proyecto, sus trabajos, todos los registros de transcripción y todos los medios generados se eliminan.

## Qué se elimina

* El registro del proyecto y cada trabajo de traducción asociado (uno por idioma de destino).
* Los segmentos de la transcripción original y cada segmento de transcripción traducido, incluido el texto que proporcionaste mediante `translatedSrt`.
* Todos los medios generados para el proyecto: vídeos y pistas de audio doblados, vídeos con sincronización labial, formas de onda, las pistas de voz aislada y de fondo, y los archivos de voz por segmento producidos para cada segmento traducido.
* El archivo de origen subido y el audio original extraído.
* Las muestras de vista previa de voces clonadas generadas para el proyecto.

Eliminar un proyecto libera el almacenamiento utilizado por los activos anteriores. Los registros que hacen referencia al proyecto se eliminan para todas las cuentas que tenían acceso a él (propietario y miembros del equipo).

## Qué no se elimina

* Las voces personalizadas guardadas en la biblioteca de voces de tu cuenta. Se comparten entre proyectos; elimínalas de la biblioteca de voces si quieres borrarlas.
* Las copias conservadas por los socios de procesamiento que produjeron la transcripción, la traducción o las voces. Esas copias siguen el período de retención propio de cada socio y no son accesibles a través de VoiceCheap.
* Los minutos ya cobrados por el proyecto no se reembolsan.

## Solicitud

### Encabezados

**x-api-key** `string` *required*

Su clave API VoiceCheap. Obtenga una en [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Parámetros de ruta

**projectId** `string` *required*

El identificador único del proyecto de traducción a eliminar.

## Respuesta

**success** `boolean` *required*

Indica que la operación de eliminación se completó correctamente.

**message** `string` *required*

Mensaje de confirmación legible por humanos.

**projectId** `string` *required*

El ID del proyecto eliminado.

## Ejemplos

```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'];
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.