Lock Sessions

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.

PATCH

lkbx

session

current

curl --request PATCH \
  --url https://dashboard.researchanddesire.com/api/v1/lkbx/session/current \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "duration": 86400
}
'

{
  "ok": true,
  "data": {
    "id": 7,
    "duration": 86400,
    "endDate": "2026-02-17T18:00:00Z",
    "lockState": "locked",
    "isActive": true
  }
}

Authorizations

Authorization

string

header

required

API tokens can be created in the Dashboard settings. Requires an Ultra subscription.

Body

application/json

Option 1
Option 2

Provide exactly one of duration (absolute) or durationChange (delta). Mixing both, or providing neither, returns 400.

duration

integer

required

New absolute duration in seconds.

Required range: x >= 1

durationChange

integer

Delta in seconds, added to the current duration. Positive to extend the lock, negative to shorten. The resulting duration must be > 0; use the unlock action to end the lock.

targetUserId

integer

User whose session to modify (defaults to authenticated user)

Response

Lock session updated

boolean

required

data

object

required

Show child attributes

List OSSM devicesReturns all Open Source Sex Machine devices registered to your account, ordered by most recently visited.

⌘I

curl --request PATCH \
  --url https://dashboard.researchanddesire.com/api/v1/lkbx/session/current \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "duration": 86400
}
'

{
  "ok": true,
  "data": {
    "id": 7,
    "duration": 86400,
    "endDate": "2026-02-17T18:00:00Z",
    "lockState": "locked",
    "isActive": true
  }
}