Sign in

v3

latestOpenAPI 3.1.2Apache 2.02026-07-31231237972.0 KB
Last Actor run's default request queue

Prolong lock on request in last run's default request queue

Prolongs a request lock in 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 Prolong request lock endpoint.

put/v2/actors/{actorId}/runs/last/request-queue/requests/{requestId}/lock

Path parameters

actorIdstring required
Example:janedoe~my-actor

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

requestIdstring required
Example:xpsmkDlspokDSmklS

Request ID.

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.

lockSecsnumber double required
Example:60

How long the requests will be locked for (in seconds).

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.

forefrontstring
Example:false

Determines if request should be added to the head of the queue or to the end after lock expires.

Response

Example response

{
  "data": {
    "lockExpiresAt": "2022-06-14T23:00:00.000Z"
  }
}