> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/api/endpoints/api-group.md).

# /api/v1/group

Manage user **groups**. A group bundles a set of users together so they can be addressed by the ACL system. Each group has an owner (`_owner`), an optional set of ACL items (`_acl`), system rights (`_system_rights`), auth-method group mappings (`_auth_method_group_maps`) and IP/subnet filters (`_ip_subnet_filter`). Groups are stored in the `group` table; create / update / delete take effect immediately on the request transaction (there is no working-copy / commit step).

Creating, updating (`POST` / `PUT`) and deleting (`DELETE`) groups require the `system.group` (or `system.root`) system right. Listing and reading groups (`GET`) require no system right — the results are filtered to the groups the current session may read (`bag_read`); a `system.root` user sees all groups.

Differs from easydb 5: easydb 5 requires an authenticated session with the `system.group` right to read groups. fylr requires no system right on `GET`; an unauthenticated list request returns an empty array rather than an error.

### `GET /group` — List all groups visible to the current session.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/group" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-5375a8600236fc27b966430adf9d1363ba403643%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `POST /group` — Create or update one or more groups.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/group" method="post" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-5375a8600236fc27b966430adf9d1363ba403643%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `PUT /group` — Create or update one or more groups (alias for POST).

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/group" method="put" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-5375a8600236fc27b966430adf9d1363ba403643%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `GET /group/{id}` — Retrieve a single group by id.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/group/{id}" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-5375a8600236fc27b966430adf9d1363ba403643%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `DELETE /group/{id}` — Delete a group by id.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/group/{id}" method="delete" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-5375a8600236fc27b966430adf9d1363ba403643%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}