Groups

The Group capability manages entries in the Groups table — the group membership lists referenced by every access policy in Arupa, from Route.Allow to a service’s own Allow. All endpoints on this page require the Group capability to be enabled; see Management API for how capabilities work.

List groups

GET /api/group

Returns every configured group and its members, sorted by name.

{
  "success": true,
  "message": "Groups fetched",
  "data": {
    "groups": [
      { "name": "administrators", "users": ["alice"] },
      { "name": "operators", "users": ["alice", "bob"] }
    ]
  }
}

Get a group

GET /api/group/{name}

Returns a single group the same way GET /api/group does, or 404 Not Found if no group with that name exists.

{
  "success": true,
  "message": "Group fetched",
  "data": { "name": "operators", "users": ["alice", "bob"] }
}

Replace a group’s members

PUT /api/group/{name}
Content-Type: application/json

{"users":["alice","bob"]}

users is required and must not be null; it replaces the group’s entire member list atomically. This is the only way to change membership — there is no endpoint to add or remove a single member, so a caller that wants to add one user must first read the current list and send it back with the new name appended. Sending an empty list ("users":[]) is valid and leaves the group with no members rather than deleting it. If {name} isn’t a configured group yet, this call creates it.

{
  "success": true,
  "message": "Group updated",
  "data": { "name": "operators", "users": ["alice", "bob"] }
}

Delete a group

DELETE /api/group/{name}

Removes the group’s entry from Groups. Any Route.Allow, service Allow, or route Access policy that names the deleted group simply never matches that group name again — deleting a group does not remove references to it elsewhere in the configuration.

{
  "success": true,
  "message": "Group deleted",
  "data": { "name": "operators" }
}

Kernel

Service

List groups

Get a group

Replace a group’s members

Delete a group

​List groups

​Get a group

​Replace a group’s members

​Delete a group

List groups

Get a group

Replace a group’s members

Delete a group