FAfal
Serverless
Apps

Flush Application Queue

Changed on

Flushes all pending requests from an application's queue.

Authentication: Required via API key

Idempotency:

  • Optional Idempotency-Key header prevents duplicate flushes on retries
  • Responses cached for 10 minutes per unique key

Use Cases:

  • Clear stuck or outdated requests from the queue
  • Reset queue state during development or testing
  • Cancel all pending requests for an application

Important:

  • This operation is irreversible
  • All pending requests in the queue will be cancelled
  • Requests already being processed will not be affected

Required permissions: serverless:queues:write. Key presets that include them: SERVERLESS, FULL. See key permissions.

delete/serverless/apps/{owner}/{name}/queue

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/serverless/apps/{owner}/{name}/queue
  • Auth
    API key in header Authorization

Path parameters

ownerstring required

Username of the app owner

Example:user_123
namestring required

Application name

Example:my-app

Headers

Idempotency-Keystring

Optional idempotency key for safe request retries

Example:550e8400-e29b-41d4-a716-446655440000

Response

Queue flushed successfully

Changes

  • 479db2f9dcd6Revision changes
    • info

      the endpoint scheme security serverlessApiKey was added to the API

    • info

      the endpoint scheme security apiKey was removed from the API