Get queue head for last run

GET 
/v2/actor-tasks/:actorTaskId/runs/last/request-queue/head

Returns the first requests from the default request queue of the last actor task 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

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

Example: janedoe~my-task

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)