Clear queued async tasks
Utilities
Clear queue
Deletes every task still in the QUEUED state for the authenticated organization, letting you drain a pending backlog in one call instead of opening a support request. Tasks that are already PROCESSING are in-flight on a worker and are left untouched, as are COMPLETED and FAILED tasks. Queued tasks have not been charged, so clearing them does not affect your credit balance. The call is safe to repeat — if the queue is already empty it simply returns cleared: 0.
DELETE
Clear queued async tasks
Overview
Use this endpoint to clear your organization’s pending async queue in a single call. It deletes every task still in theQUEUED state, which is useful when
you’ve enqueued a large backlog by mistake or want to reset the queue instead of
waiting for it to drain (or opening a support request).
Only queued tasks are affected:
QUEUEDtasks are removed.PROCESSINGtasks are already in-flight on a worker and are left running — they cannot be recalled from here.COMPLETEDandFAILEDtasks are historical and are left in place; you can still retrieve them viaGET /v1/async/task/{taskId}until they age out of the retention window.
Billing
Queued tasks have not been charged yet — credits are only deducted once a task is processed. Clearing the queue therefore has no effect on your credit balance, and no refund is issued.Idempotency
The call is safe to repeat. If the queue is already empty, it returnscleared: 0 rather than an error.
Checking the queue first
To see how many tasks are currently queued before clearing, use the async status endpoint.Example usage
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.