Skip to content

Replace typed group policy

PUT
/api/v1/screen-groups/{id}/policy
curl --request PUT \
--url https://example.com/api/v1/screen-groups/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/policy \
--header 'Content-Type: application/json' \
--data '{ "revision": 1, "priority": 1, "values": {} }'

Requires an authenticated dashboard user.

id
required
string format: uuid
Media typeapplication/json
object
revision
required

Revision the caller last read; a stale value fails with 409.

integer format: int64
priority

Group policies only. Higher priority wins between groups.

integer
values
required

Registry setting keys to values. Validated against the closed typed settings registry.

object
key
additional properties
any
Examplegenerated
{
"revision": 1,
"priority": 1,
"values": {}
}

Updated policy

Media typeapplication/json
object
data
required
object
schemaVersion
required
integer
>= 1
revision
required
integer format: int64
priority
integer
values
required
object
key
additional properties
any
updatedAt
required
string format: date-time
Examplegenerated
{
"data": {
"schemaVersion": 1,
"revision": 1,
"priority": 1,
"values": {},
"updatedAt": "2026-04-15T12:00:00Z"
}
}

Revision conflict