# /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-2a59a53c20c205492524eecbc6914f9b2357ef2a%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-2a59a53c20c205492524eecbc6914f9b2357ef2a%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-2a59a53c20c205492524eecbc6914f9b2357ef2a%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-2a59a53c20c205492524eecbc6914f9b2357ef2a%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-2a59a53c20c205492524eecbc6914f9b2357ef2a%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fylr.io/for-developers/api/endpoints/api-group.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.