Get request from queue for last run

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

Returns a request from the default request queue of the last actor task run. Redispatches to Get request.

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
requestId string required
Request ID.

Example: xpsmkDlspokDSmklS

Query Parameters

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

Example: SUCCEEDED

Status 200

Response Headers

{
  "data": {
    "id": "dnjkDMKLmdlkmlkmld",
    "uniqueKey": "GET|60d83e70|e3b0c442|https://apify.com/career",
    "url": "https://apify.com/career",
    "method": "GET",
    "retryCount": 0,
    "loadedUrl": "https://apify.com/jobs",
    "payload": "Unknown Type: object,null",
    "headers": "Unknown Type: object,null",
    "userData": {
      "label": "DETAIL",
      "image": "https://picserver1.eu"
    },
    "noRetry": false,
    "errorMessages": "Unknown Type: array,null",
    "handledAt": "2019-06-16T10:23:31.607Z"
  }
}

Schema

• data object required

  A request stored in the request queue, including its metadata and processing state.

  • id string required

    A unique identifier assigned to the request.

    
    Example: dnjkDMKLmdlkmlkmld
  • 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/career
  • url string<uri> required

    The URL of the request.

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

    The HTTP method of the request.

    
    Example: GET
  • retryCount integer

    The number of times this request has been retried.

    
    Example: 0
  • loadedUrl string,null<uri> nullable

    The final URL that was loaded, after redirects (if any).

    
    Example: https://apify.com/jobs
  • payload object | null nullable

    The request payload, typically used with POST or PUT requests.

  • headers object | null nullable

    HTTP headers sent with the request.

  • userData object

    Custom user data attached to the request. Can contain arbitrary fields.

    • label string | null nullable

      Optional label for categorizing the request.

      
      Example: DETAIL
    • image string,null<uri> nullable

      Optional image URL associated with the request.

      
      Example: https://picserver1.eu
    • property name* any

      Custom user data attached to the request. Can contain arbitrary fields.

  • noRetry boolean | null nullable

    Indicates whether the request should not be retried if processing fails.

    
    Example: false
  • errorMessages string[] nullable

    Error messages recorded from failed processing attempts.

  • handledAt string,null<date-time> nullable

    The timestamp when the request was marked as handled, if applicable.

    
    Example: 2019-06-16T10:23:31.607Z

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)