Policy GroupsUpdate a policy group (admin)

Update a policy group (admin)

Partial update: name, description, UI metadata (logoUri/color/emoji; null clears). code and vaultId are immutable, since actorRole.groupCodes selectors reference the code.

curl -X PATCH "https://policy-engine-rest.ezig.workers.dev/api/v1/policy-groups/example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "name": "John Doe",
  "description": "example_string",
  "logoUri": "example_string",
  "color": "example_string",
  "emoji": "example_string"
}'
{
  "id": "cmr3f41z20001psp7phmyapw3",
  "vaultId": "example_string",
  "code": "traders",
  "name": "John Doe",
  "description": "example_string",
  "logoUri": "example_string",
  "color": "#0A84FF",
  "emoji": "👥",
  "createdAt": "2026-07-02T11:25:15.134000Z",
  "updatedAt": "2026-07-02T11:25:15.134000Z"
}
PATCH
/api/v1/policy-groups/{id}
PATCH
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Session token. Mobile/services. The web uses a cookie.

Session token. Mobile/services. The web uses a cookie.
API Key (cookie: session_token)
session_tokenstring
Required

API key (sent in cookie)

Content-Typestring
Required

The media type of the request body

Options: application/json
namestring
Min length: 1
logoUristring

null removes the logo

colorstring

null removes the color

emojistring

null removes the emoji

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Session token. Mobile/services. The web uses a cookie.

path
parameterstring
Required

API Key for authentication. Provide your API key in the cookie.

Path Parameters

Body

application/json
logoUristring

null removes the logo

colorstring

null removes the color

emojistring

null removes the emoji

Responses

idstring
Required

cuid

vaultIdstring
Required
codestring
Required
namestring
Required
descriptionstring
Required
logoUristring
Required
colorstring
Required
emojistring
Required
createdAtstring
Required
updatedAtstring
Required