POST
/
setPermissions
curl -X POST -H 'Authorization: Bearer <your-api-key>' \
    <base_url>/setPermissions -d '["<user_id>", {"control_disabled": false, "control_exclusive": true}]'

​
Parameters

​
priority
integer
default:0

Higher value = higher priority. Users with a higher priority will preempt the control of lower priority users.

​
idle_timeout
integer
default:0

Number of milliseconds until a user is considered “idle”. Once a user is considered idle, they no longer preempt lower priority users until they interact with the virtual browser again.

​
control_disabled
boolean
default:"{control_disable_default}"

If control_disabled = true, all control input (mouse movements, keyboard presses) will be ignored. Note that disabling control does not restrict access to any APIs that require admin tokens.

curl -X POST -H 'Authorization: Bearer <your-api-key>' \
    <base_url>/setPermissions -d '["<user_id>", {"control_disabled": false, "control_exclusive": true}]'

The request body mirrors the function signature of setPermissions(userId, permissions) from the JavaScript SDK.