Skip to content

Clean jobs from queue

DELETE
/api/queue/{name}/jobs
curl --request DELETE \
--url 'https://example.com/api/queue/conversion/jobs?jobState=completed' \
--header 'Authorization: Bearer <token>'

Removes all jobs in a specific state from the queue

name
required

Queue name

string
Example
conversion
jobState
required

Job state to clean (required)

string
Allowed values: completed failed

Jobs cleaned successfully

Media typeapplication/json
object
status
required

Operation status

string
message
required

Status message

string
Example
{
"status": "Success",
"message": "Job removed from queue"
}

Missing jobState parameter or failed to remove jobs

Media typeapplication/json
object
error
required

Indicates an error occurred

boolean
message
required

Error message describing what went wrong

string
Example
{
"error": true,
"message": "Item not found"
}