Delete Job

April 6, 2026

Table of contents

  1. Request Headers
  2. Path Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

Remove a completed or failed job from the executing jobs tracker. Use this to clean up jobs that are no longer needed in the active queue.

https://api.useapi.net/v1/luma/jobs/jobid

Request Headers 

Authorization: Bearer {API token}

Path Parameters

Responses

  • 200 OK

    Job successfully removed from the executing tracker.

    {
  "jobid": "j0326140530123456789v-u12345-email:[email protected]:a1b2c3d4-e5f6-7890-abcd-ef1234567890-bot:luma",
  "deleted": true
}
    • jobid - The job identifier that was deleted.
    • deleted - Confirmation of deletion (true).

  • 400 Bad Request

    Invalid job ID format.

    {
  "error": "Invalid jobid"
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "Unauthorized"
}

  • 403 Forbidden

    Job does not belong to this user.

    {
  "error": "Job does not belong to this user"
}

  • 404 Not Found

    Job not found or has expired.

    {
  "error": "Job not found"
}

  • 409 Conflict

    Cannot delete a job that is not in a terminal state.

    {
  "error": "Cannot delete job in state 'processing'. Wait for completion."
}

Model 

{
  jobid: string                    // Job identifier that was deleted
  deleted: true                    // Confirmation of deletion
  error?: string                   // Error message
}

Examples 

  • curl -X DELETE \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v1/luma/jobs/j0326140530123456789v-u12345-email:[email protected]:a1b2c3d4-e5f6-7890-abcd-ef1234567890-bot:luma"

  • const token = 'YOUR_API_TOKEN'
const jobId = 'j0326140530123456789v-u12345-email:[email protected]:a1b2c3d4-e5f6-7890-abcd-ef1234567890-bot:luma'

const response = await fetch(`https://api.useapi.net/v1/luma/jobs/${jobId}`, {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${token}`
  }
})

const result = await response.json()
console.log('Deleted:', result.deleted)

  • import requests

token = 'YOUR_API_TOKEN'
job_id = 'j0326140530123456789v-u12345-email:[email protected]:a1b2c3d4-e5f6-7890-abcd-ef1234567890-bot:luma'

response = requests.delete(
    f'https://api.useapi.net/v1/luma/jobs/{job_id}',
    headers={'Authorization': f'Bearer {token}'}
)

result = response.json()
print(f"Deleted: {result['deleted']}")

Try It