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

# Delete Project

> Permanently delete a translation project

# Delete Project

Permanently delete a translation project and its associated assets.

Project records are always deleted. Media deletion is best effort: if a stored file cannot be removed, or was already removed before deletion completes, the cleanup logs it, continues and still finalizes the project deletion. A generated file can therefore occasionally remain in storage.

> [!WARNING]
>
> This operation is irreversible. The project, its works, all transcript records and all generated media are deleted.

## What is deleted

* The project record and every translation work attached to it (one per target language).
* The original transcript segments and every translated transcript segment, including the text you supplied through `translatedSrt`.
* All media generated for the project: dubbed videos and audio tracks, lip-synced videos, waveforms, the isolated voice and background tracks, and the per-segment speech files produced for each translated segment.
* The uploaded source file and the extracted original audio.
* The cloned voice preview samples generated for the project.

Deleting a project releases the storage used by the assets above. Records that reference the project are removed for every account that had access to it (owner and team members).

## What is not deleted

* Custom voices saved to your account voice library. They are shared across projects; remove them from the voice library if you want them deleted.
* Copies held by the processing partners that produced the transcription, the translation or the voices. Those copies follow each partner's own retention period and are not accessible through VoiceCheap.
* Minutes already charged for the project are not refunded.

## Request

### Headers

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

Your VoiceCheap API key. Get one from [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Path Parameters

**projectId** `string` *required*

The unique identifier of the translation project to delete.

## Response

**success** `boolean` *required*

Indicates the delete operation completed successfully.

**message** `string` *required*

Human-readable confirmation message.

**projectId** `string` *required*

The ID of the deleted project.

## Examples

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

## Errors

| Status | Code | Description |
| - | - | - |
| 401 | `INVALID_API_KEY` | The provided API key is invalid |
| 403 | `FORBIDDEN` | You don't have permission to delete this project |
| 404 | `PROJECT_NOT_FOUND` | The specified project does not exist |
| 429 | `RATE_LIMIT_EXCEEDED` | Too many requests (limit: 10 requests per minute) |
| 500 | `INTERNAL_ERROR` | Unexpected server error |


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