Skip to main content

Delete requests

DELETE 
/v2/request-queues/:queueId/requests/batch

Batch-deletes given requests from the queue. The number of requests in a batch is limited to 25. The response contains an array of unprocessed and processed requests. If any delete operation fails because the request queue rate limit is exceeded or an internal failure occurs, the failed request is returned in the unprocessedRequests response parameter. You can re-send these delete requests. It is recommended to use an exponential backoff algorithm for these retries. Each request is identified by its ID or uniqueKey parameter. You can use either of them to identify the request.

Request

Path Parameters

    queueId string required

    Queue ID or username~queue-name.


    Example: WkzbQMuFYuamGv3YF

Query Parameters

    clientKey string

    A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long


    Example: client-abc

Header Parameters

    Content-Type string required

    Possible values: [application/json]


    Example: application/json

Status 204

Response Headers
    {
      "data": {
        "processedRequests": [
          {
            "uniqueKey": "http://example.com"
          }
        ],
        "unprocessedRequests": [
          {
            "uniqueKey": "http://example.com/2",
            "id": "sbJ7klsdf7ujN9l",
            "url": "http://example.com/2",
            "method": "GET"
          }
        ]
      }
    }