Modify active lock session
Modify the duration of the active lock session. Only keyholders or
test lock owners can modify sessions (self-lock owners may only
extend, never shorten).
Provide either duration (absolute new duration in seconds) or
durationChange (relative delta in seconds — positive to add time,
negative to subtract). The delta form is intended for game / external
integrations that want to add or remove time without first fetching
the current session.
Authorizations
AuthorizationstringheaderrequiredAPI tokens can be created in the Dashboard settings. Requires an Ultra subscription.
Body
Provide exactly one of duration (absolute) or durationChange
(delta). Mixing both, or providing neither, returns 400.
Response
200application/jsonLock session updated
Lock session updated
okbooleanrequireddataobjectrequiredShow child attributes
idintegerdurationintegerendDatestring<date-time>lockStatestringisActiveboolean400application/jsonInvalid request
Invalid request
okbooleanrequirederrorstringrequired401application/jsonAuthentication required or token invalid
Authentication required or token invalid
okbooleanrequirederrorstringrequired403application/jsonNot authorized to modify
Not authorized to modify
okbooleanrequirederrorstringrequired404application/jsonNo active session or user not found
No active session or user not found
okbooleanrequirederrorstringrequired