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

# Projekt löschen

> Ein Übersetzungsprojekt dauerhaft löschen

# Projekt löschen

Ein Übersetzungsprojekt und die damit verbundenen Assets dauerhaft löschen.

Diese Bereinigung entfernt auch alle gespeicherten Vorschau-Beispieldateien für Stimmklonen, die für das Projekt generiert wurden.

Falls einige intern generierte Dateien oder Segmentdatensätze bereits vor Abschluss der Löschung entfernt wurden, wird die Bereinigung im Best-Effort-Modus fortgesetzt und schließt die Projektlöschung dennoch ab.

<Warning>
  Dieser Vorgang ist unwiderruflich. Das Projekt, die Arbeiten, die generierten Medien-Assets und die gespeicherten Vorschau-Beispieldateien für Stimmen werden gelöscht.
</Warning>

## Anfrage

### Header

<ParamField header="x-api-key" type="string" required>
  Ihr VoiceCheap API-Schlüssel. Holen Sie sich einen von [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).
</ParamField>

### Pfadparameter

<ParamField path="projectId" type="string" required>
  Die eindeutige Kennung des zu löschenden Übersetzungsprojekts.
</ParamField>

## Antwort

<ResponseField name="success" type="boolean" required>
  Gibt an, dass der Löschvorgang erfolgreich abgeschlossen wurde.
</ResponseField>

<ResponseField name="message" type="string" required>
  Für Menschen lesbare Bestätigungsnachricht.
</ResponseField>

<ResponseField name="projectId" type="string" required>
  Die ID des gelöschten Projekts.
</ResponseField>

## Beispiele

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

## Fehler

| Status | Code                  | Beschreibung                                            |
| ------ | --------------------- | ------------------------------------------------------- |
| 401    | `INVALID_API_KEY`     | Der bereitgestellte API-Schlüssel ist ungültig          |
| 403    | `FORBIDDEN`           | Sie haben keine Berechtigung, dieses Projekt zu löschen |
| 404    | `PROJECT_NOT_FOUND`   | Das angegebene Projekt existiert nicht                  |
| 429    | `RATE_LIMIT_EXCEEDED` | Zu viele Anfragen (Limit: 10 Anfragen pro Minute)       |
| 500    | `INTERNAL_ERROR`      | Unerwarteter Serverfehler                               |