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

cloro API key as a bearer token. One key grants every endpoint in this spec; per-key scopes are not available, so a client cannot request a narrower permission. Keys are created, rotated, and revoked at https://dashboard.cloro.dev/api-keys. Full details, including the versioning and deprecation policy, are at https://cloro.dev/auth.md.

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