Sign in

Create (or replace) a group at runtime, live immediately (upsert)

Changed on
post/api/v1/admin/groups

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header x-admin-token
    • HTTP bearer

Headers

If-Matchstring

Optimistic concurrency: the resource's ETag from a prior read (or the ETag returned by the previous mutation). Stale = 409 version_conflict (re-read and retry), nothing changes; absent or * = unconditional.

Request body

configobject required

A groups: entry, as JSON. The accepted shape is the config file's own, documented in the configuration reference; it is not restated here because several of its types parse a wire shape that does not match their field layout.

namestring required

The group name.

Response

Replaced: the name existed (body is the group definition)

enabledboolean required

false FREEZES the group (every request charging through it is rejected; history kept).

namestring required
parentstring nullable

The parent group whose limits this one is ANDed under (the enforcement chain). None = a root group. Skipped from the body when absent.

Changes