Unlock requests
POST/v2/request-queues/:queueId/requests/unlock
Unlocks requests in the queue that are currently locked by the client.
- If the client is within an Actor run, it unlocks all requests locked by that specific run plus all requests locked by the same clientKey.
- If the client is outside of an Actor run, it unlocks all requests locked using the same clientKey.
Request
Path Parameters
queueId string required
Queue ID or username~queue-name.
WkzbQMuFYuamGv3YFQuery Parameters
clientKey string
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long
Example:client-abcStatus 200
Number of requests that were unlocked
{
"data": {
"unlockedCount": 10
}
}
Schema
data object required
Result of unlocking requests in the request queue.
- unlockedCount integer required
Number of requests that were successfully unlocked.
Example:10
- unlockedCount integer 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: