Acquire Update Lock

Acquire an update lock for coordinated rolling updates.

This ensures only one worker in a queue updates at a time. Uses Redis for distributed locking with automatic TTL expiration.

Args: queue_id: Worker queue ID worker_id: Worker ID requesting the lock lock_request: Lock configuration (duration)

Returns: Lock information if acquired, or error if another worker holds the lock

Path Parameters

queue_id · string · required

worker_id · string · required

Body

application/json

Request to acquire an update lock for coordinated rolling updates

worker_id · string · required

lock_duration_seconds · integer · default: 300

Lock TTL (60-600 seconds)

Required range: 60 <= x <= 600

Response

200

application/json

Successful Response

Response with update lock information

lock_id · string · required

worker_id · string · required

queue_id · string · required

acquired_at · string · required

expires_at · string · required

locked · boolean · required