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"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:
- Job Record: The job entry in the database
- Original File: The uploaded i18n file (JSON, YAML, PO, etc.)
- Translated Files: All generated translated files for each target language
- File Metadata: All associated file records and metadata
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
- Always download translated files before deleting jobs if you need to keep them
- Use the List Jobs endpoint to verify job ownership before deletion
- Consider archiving important translations before deletion
- Deletion is useful for cleaning up test jobs or failed translations