v3

OpenAPI 3.1.2Apache 2.02026-07-31231237972.0 KB

Last Actor run's default request queue

List last run's default request queue's requests

Returns a list of requests from the default request queue of the last Actor run.

This endpoint is a shortcut for getting the last run's defaultRequestQueueId and then using the List requests endpoint.

get/v2/actors/{actorId}/runs/last/request-queue/requests

Path parameters

actorIdstring required

Example:janedoe~my-actor

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

Query parameters

statusstring

Example:SUCCEEDED

Filter for the run status.

origin'DEVELOPMENT' | 'WEB' | 'API' | 'SCHEDULER' | 'TEST' | 'WEBHOOK' | 'ACTOR' | 'CLI' | 'CI' | 'STANDBY' | 'MCP'

Filter for the run origin, i.e. the means by which the run was started.

clientKeystring

Example:client-abc

A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey is not provided, the system considers this API call to come from a new client. For details, see the hadMultipleClients field returned by the Get head operation.

exclusiveStartIdstring

Example:Ihnsp8YrvJ8102Kj

All requests up to this one (including) are skipped from the result. (Deprecated, use cursor instead.)

limitnumber double

Example:100

Number of keys to be returned. Maximum value is 10000.

cursorstring

Example:eyJyZXF1ZXN0SWQiOiI2OFRqQ2RaTDNvM2hiUU0ifQ

A cursor string for pagination, returned in the previous response as nextCursor. Use this to retrieve the next page of requests.

filterstring[]

Filter requests by their state. Possible values are locked and pending. You can combine multiple values separated by commas, which will mean the union of these filters – requests matching any of the specified states will be returned. (Not compatible with deprecated exclusiveStartId parameter.)

[
  "locked"
]

Response

Example response

{
  "data": {
    "items": [
      {
        "id": "dnjkDMKLmdlkmlkmld",
        "retryCount": 0,
        "uniqueKey": "http://example.com",
        "url": "http://example.com",
        "method": "GET",
        "loadedUrl": "http://example.com/example-1",
        "payload": null,
        "noRetry": false,
        "errorMessages": null,
        "headers": null,
        "userData": {
          "label": "DETAIL",
          "image": "https://picserver1.eu"
        },
        "handledAt": "2019-06-16T10:23:31.607Z"
      },
      {
        "id": "dnjkDMKLmdlkmlkmld",
        "retryCount": 0,
        "uniqueKey": "http://example.com",
        "url": "http://example.com",
        "method": "GET",
        "loadedUrl": "http://example.com/example-1",
        "payload": null,
        "noRetry": false,
        "errorMessages": null,
        "headers": null,
        "userData": {
          "label": "DETAIL",
          "image": "https://picserver1.eu"
        },
        "handledAt": "2019-06-16T10:23:31.607Z"
      }
    ],
    "limit": 2,
    "exclusiveStartId": "Ihnsp8YrvJ8102Kj"
  }
}