Get queue head for last run

GET 
/v2/acts/:actorId/runs/last/request-queue/head

Returns the first requests from the default request queue of the last Actor run. Redispatches to Get head.

Using the status query parameter you can ensure to only get a run with a certain status (e.g. status=SUCCEEDED). Only the most recent run with that status is used.

Request

Path Parameters

actorId string required
Actor ID or a tilde-separated owner's username and Actor name.

Example: janedoe~my-actor

Query Parameters

status string
Filter for the run status. Only the most recent run with this status is used.

Example: SUCCEEDED
limit number
Maximum number of requests to return.

Example: 100
clientKey string

A unique identifier of the client accessing the request queue.

Status 200

Response Headers

{
  "data": {
    "limit": 1000,
    "queueModifiedAt": "2018-03-14T23:00:00.000Z",
    "hadMultipleClients": false,
    "items": [
      {
        "id": "8OamqXBCpPHxyH9",
        "uniqueKey": "GET|60d83e70|e3b0c442|https://apify.com",
        "url": "https://apify.com",
        "method": "GET",
        "retryCount": 0
      }
    ]
  }
}

Schema

• data object required

  A batch of requests from the request queue head without locking.

  • limit integer required

    The maximum number of requests returned.

    
    Example: 1000
  • queueModifiedAt string<date-time> required

    The timestamp when the request queue was last modified.

    
    Example: 2018-03-14T23:00:00.000Z
  • hadMultipleClients boolean required

    Whether the request queue has been accessed by multiple different clients.

    
    Example: false
  • items object[] required

    The array of requests from the request queue head.

    • id string required

      A unique identifier assigned to the request.

      
      Example: 8OamqXBCpPHxyH9
    • uniqueKey string required

      A unique key used for request de-duplication. Requests with the same unique key are considered identical.

      
      Example: GET|60d83e70|e3b0c442|https://apify.com
    • url string<uri> required

      The URL of the request.

      
      Example: https://apify.com
    • method string

      The HTTP method of the request.

      
      Example: GET
    • retryCount integer

      The number of times this request has been retried.

      
      Example: 0

Status 400

Bad request - invalid input parameters or request body.

{
  "error": {
    "type": "invalid-input",
    "message": "Invalid input: The request body contains invalid data."
  }
}

Schema

• error object required

  • type string required
    Example: run-failed
  • message string required
    Example: Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)