Delete Project

curl --request DELETE \
  --url https://api.voicecheap.ai/v1/translate/{projectId} \
  --header 'x-api-key: <x-api-key>'

import requests

url = "https://api.voicecheap.ai/v1/translate/{projectId}"

headers = {"x-api-key": "<x-api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api.voicecheap.ai/v1/translate/{projectId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.voicecheap.ai/v1/translate/{projectId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.voicecheap.ai/v1/translate/{projectId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.voicecheap.ai/v1/translate/{projectId}")
  .header("x-api-key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.voicecheap.ai/v1/translate/{projectId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "projectId": "<string>"
}

Delete Project

curl --request DELETE \
  --url https://api.voicecheap.ai/v1/translate/{projectId} \
  --header 'x-api-key: <x-api-key>'

import requests

url = "https://api.voicecheap.ai/v1/translate/{projectId}"

headers = {"x-api-key": "<x-api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api.voicecheap.ai/v1/translate/{projectId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.voicecheap.ai/v1/translate/{projectId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.voicecheap.ai/v1/translate/{projectId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.voicecheap.ai/v1/translate/{projectId}")
  .header("x-api-key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.voicecheap.ai/v1/translate/{projectId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "projectId": "<string>"
}

Delete Project

Permanently delete a translation project and its associated assets. This cleanup also removes any stored cloned voice preview example files that were generated for the project. If some internal generated files or segment records were already removed before deletion completes, cleanup continues in best-effort mode and still finalizes the project deletion.

This operation is irreversible. The project, works, generated media assets, and stored voice preview example files will be deleted.

Request

Headers

x-api-key

string

required

Your VoiceCheap API key. Get one from 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

curl -X DELETE "https://api.voicecheap.ai/v1/translate/abc123-def456-ghi789" \
  -H "x-api-key: vc_your-api-key"

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

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

Get Project Details Error Codes

Overview

Translation

Reference

Delete Project

Delete Project

Request

Headers

Path Parameters

Response

Examples

Errors

​Delete Project

​Request

​Headers

​Path Parameters

​Response

​Examples

​Errors

Delete Project

Request

Headers

Path Parameters

Response

Examples

Errors