Skip to main content
ZStack
Infrastructure/Agents

UpdateLockConfig

Update the global lock configuration for TTL and auto-release behavior

PUT/api/v1/agents/locks/config

Operation ID

UpdateLockConfig

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Body Fields

  • lockTtlMinutes
    IntegerRequired

    Updated lock TTL in minutes

    Example: 30

  • allowForceUnlock
    BooleanRequired

    Whether to allow force unlock

    Example: true

  • requireIfMatchHeader
    BooleanRequired

    Whether to require If-Match header on updates

    Example: true

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • defaultTtlSeconds
    Integer

    Default lock TTL in seconds if not specified at acquire time

    Example: 300

  • maxTtlSeconds
    Integer

    Maximum allowed TTL in seconds for any lock

    Example: 3600

  • autoReleaseEnabled
    Boolean

    Whether expired locks are automatically released by the system

    Example: true