Add request to queue for last run
POST/v2/actor-tasks/:actorTaskId/runs/last/request-queue/requests
Adds a request to the default request queue of the last actor task run. Redispatches to Add 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
Task ID or a tilde-separated owner's username and Actor task name.
Example:janedoe~my-taskQuery Parameters
Filter for the run status. Only the most recent run with this status is used.
Example:SUCCEEDEDBodyrequired
- id string
A unique identifier assigned to the request.
Example:sbJ7klsdf7ujN9l - 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 required
The HTTP method of the request.
Example:GET
Status 201
Response Headers
{
"data": {
"requestId": "YiKoxjkaS9gjGTqhF",
"wasAlreadyPresent": false,
"wasAlreadyHandled": false
}
}
Schema
data object required
Result of registering a request in the request queue, either by adding a new request or updating an existing one.
- requestId string required
A unique identifier assigned to the request.
Example:YiKoxjkaS9gjGTqhF - wasAlreadyPresent boolean required
Indicates whether a request with the same unique key already existed in the request queue. If true, no new request was created.
Example:false - wasAlreadyHandled boolean required
Indicates whether a request with the same unique key has already been processed by the request queue.
Example:false
- requestId string required
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 requiredExample:
run-failed - message string requiredExample:
Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)
- type string requiredExample: