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

# Usuń projekt

> Trwałe usuwanie projektu tłumaczeniowego

# Usuń projekt

Trwale usuwa projekt tłumaczeniowy oraz powiązane z nim zasoby.

To czyszczenie usuwa również wszelkie zapisane przykładowe pliki podglądu klonowania głosu, które zostały wygenerowane dla projektu.

Jeśli niektóre wewnętrzne wygenerowane pliki lub rekordy segmentów zostały już usunięte przed zakończeniem usuwania, czyszczenie jest kontynuowane w trybie najlepszych starań i nadal finalizuje usuwanie projektu.

<Warning>
  Ta operacja jest nieodwracalna. Projekt, prace, wygenerowane zasoby multimedialne oraz zapisane przykładowe pliki podglądu głosu zostaną usunięte.
</Warning>

## Żądanie

### Nagłówki

<ParamField header="x-api-key" type="string" required>
  Twój klucz API VoiceCheap. Uzyskaj go z [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).
</ParamField>

### Parametry ścieżki

<ParamField path="projectId" type="string" required>
  Unikalny identyfikator projektu tłumaczeniowego do usunięcia.
</ParamField>

## Odpowiedź

<ResponseField name="success" type="boolean" required>
  Wskazuje, że operacja usuwania zakończyła się pomyślnie.
</ResponseField>

<ResponseField name="message" type="string" required>
  Czytelny dla człowieka komunikat potwierdzający.
</ResponseField>

<ResponseField name="projectId" type="string" required>
  ID usuniętego projektu.
</ResponseField>

## Przykłady

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

## Błędy

| Status | Kod                   | Opis                                          |
| ------ | --------------------- | --------------------------------------------- |
| 401    | `INVALID_API_KEY`     | Podany klucz API jest nieprawidłowy           |
| 403    | `FORBIDDEN`           | Nie masz uprawnień do usunięcia tego projektu |
| 404    | `PROJECT_NOT_FOUND`   | Określony projekt nie istnieje                |
| 429    | `RATE_LIMIT_EXCEEDED` | Zbyt wiele żądań (limit: 10 żądań na minutę)  |
| 500    | `INTERNAL_ERROR`      | Nieoczekiwany błąd serwera                    |
