Groups

Catalog groups (grupos).

📄️ Get group by ID

Returns a single group by its primary key. The response carries a strong `ETag` header with the current version.

📄️ Update group

Full replacement of an existing group. Send the `If-Match` header with the current ETag for optimistic concurrency control.

📄️ Delete group

Deletes a group. Send the `If-Match` header with the current ETag for optimistic concurrency control.

📄️ Merge-patch group

RFC 7396 merge-patch over `application/merge-patch+json`. Send only the fields you want to change; include a field with value `null` to remove it. Use the `If-Match` header for optimistic concurrency control.

📄️ List groups

Returns a paginated list of groups with envelope `{data, totalCount, skip, limit, hasMore}`. Default sort is `name:asc`. Limit is capped at 200; skip is clamped to >= 0.

📄️ Create group

Creates a new group. Business logic runs in the legacy WAR via the internal commands gateway.

📄️ Prototype group for a creation form

Returns a non-persisted group pre-populated with backend defaults. Optional hints include `companyId` and `copyFromId`. The response has no `id`, `version` or audit fields; call `POST /api/v2/groups` afterwards to persist it.