title: Delete i18n Translation Job description: Permanently delete a translation job and all its associated files

Delete i18n Translation Job

Permanently delete a translation job and all its associated files.

Endpoint

DELETE /v2/translate/i18n/jobs/{job_id}

Description

Permanently delete a translation job and all its associated files (original file and all translated files). This action cannot be undone.

⚠️

Warning: This operation is permanent and irreversible. All files associated with the job (original file and translated files) will be permanently deleted from storage.

Headers

X-API-KEY string (required) : Your API key for authentication

Path Parameters

job_id string (UUID, required) : Unique identifier of the translation job to delete

Example Request

curl -X DELETE https://api.translateplus.io/v2/translate/i18n/jobs/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-KEY: your_api_key"

import requests

url = "https://api.translateplus.io/v2/translate/i18n/jobs/550e8400-e29b-41d4-a716-446655440000"
headers = {
    "X-API-KEY": "your_api_key"
}

response = requests.delete(url, headers=headers)
print(response.json())
# Output: {"message": "Translation job deleted successfully"}

const jobId = '550e8400-e29b-41d4-a716-446655440000';

fetch(`https://api.translateplus.io/v2/translate/i18n/jobs/${jobId}`, {
  method: 'DELETE',
  headers: {
    'X-API-KEY': 'your_api_key'
  }
})
.then(response => response.json())
.then(data => {
  console.log(data.message);
  // Output: "Translation job deleted successfully"
})
.catch(error => console.error('Error:', error));

const https = require('https');

const jobId = '550e8400-e29b-41d4-a716-446655440000';
const options = {
  hostname: new URL('https://api.translateplus.io').hostname,
  path: `/v2/translate/i18n/jobs/${jobId}`,
  method: 'DELETE',
  headers: {
    'X-API-KEY': 'your_api_key'
  }
};

const req = https.request(options, (res) => {
  let responseData = '';
  res.on('data', (chunk) => {
    responseData += chunk;
  });
  res.on('end', () => {
    const result = JSON.parse(responseData);
    console.log(result.message);
  });
});

req.on('error', (error) => {
  console.error('Error:', error);
});

req.end();

<?php

$jobId = '550e8400-e29b-41d4-a716-446655440000';
$url = "https://api.translateplus.io/v2/translate/i18n/jobs/{$jobId}";
$apiKey = 'your_api_key';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: ' . $apiKey
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $result = json_decode($response, true);
    echo $result['message'];
} else {
    echo 'Error: ' . $response;
}

Success Response (200 OK)

{
  "message": "Translation job deleted successfully"
}

Response Fields

| Field | Type | Description | |-------|------|-------------| | message | string | Success confirmation message |

What Gets Deleted

When you delete a translation job, the following items are permanently removed:

ℹ️

Note: Deletion is immediate and cannot be undone. Make sure you have downloaded any translated files you need before deleting the job.

Error Responses

404 Not Found

Job not found or does not belong to the authenticated user:

{
  "detail": "Job not found."
}

401 Unauthorized / 403 Forbidden

Invalid or missing API key:

{
  "detail": "Invalid API key. Please verify your API key is valid."
}

401 Unauthorized

Job belongs to a different user:

{
  "detail": "You do not have permission to delete this job"
}

Best Practices