Skip to main content

Delete Job

Delete a split job and all associated segments. This action is irreversible.

DELETE /api/v1/splits/:jobId

Authentication​

API Key required via X-API-Key header.

Path Parameters​

ParameterTypeDescription
jobIdstringThe job ID (e.g., job_abc123)

Response​

204 No Content​

Returned on successful deletion. No response body.

404 Not Found​

{
  "error": {
    "code": "JOB_NOT_FOUND",
    "message": "Job job_xyz789 not found",
    "status": 404
  }
}

409 Conflict​

{
  "error": {
    "code": "JOB_ALREADY_PROCESSING",
    "message": "Cannot delete a job that is currently processing",
    "status": 409
  }
}

Code Examples​

cURL​

curl -X DELETE https://api.audiospliter.com/api/v1/splits/job_abc123 \
  -H "X-API-Key: as_live_abc123"

Node.js​

const response = await fetch(
  'https://api.audiospliter.com/api/v1/splits/job_abc123',
  {
    method: 'DELETE',
    headers: { 'X-API-Key': process.env.AUDIOSPLITER_API_KEY },
  }
);

if (response.status === 204) {
  console.log('Job deleted successfully');
}

Python​

import requests, os

response = requests.delete(
    'https://api.audiospliter.com/api/v1/splits/job_abc123',
    headers={'X-API-Key': os.environ['AUDIOSPLITER_API_KEY']},
)

if response.status_code == 204:
    print('Job deleted successfully')

Rate Limiting​

This endpoint counts toward your per-minute rate limit. See Rate Limits.