Skip to main content
DELETE
Clear queued async tasks
Clears your organization’s pending async queue in a single call — useful when you’ve enqueued a large backlog by mistake or want to reset the queue instead of waiting for it to drain. Only queued tasks are affected:
  • QUEUED tasks are removed.
  • PROCESSING tasks are already in-flight on a worker and are left running — they cannot be recalled from here.
  • COMPLETED and FAILED tasks are historical and are left in place; you can still retrieve them via GET /v1/async/task/{taskId} until they age out of the retention window.
Credits are only deducted once a task is processed, so clearing the queue has no effect on your credit balance and no refund is issued. The call is safe to repeat: an already-empty queue returns cleared: 0 rather than an error. To check how many tasks are queued before clearing, use the async status endpoint.

Example usage

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Queue cleared. Returns the number of queued tasks that were removed.

success
boolean
required

Indicates the queue was cleared successfully.

Example:

true

cleared
integer
required

Number of queued tasks that were removed.

Example:

42