---
title: "Returns a single usergroup"
method: GET
path: "/user-groups/{usergroup_id}"
tags: ["Usergroups"]
---

# Returns a single usergroup

`GET /user-groups/{usergroup_id}`

## Request

- Base URL: `https://api.kontainer.com/jsonapi/v2`
- URL: `https://api.kontainer.com/jsonapi/v2/user-groups/{usergroup_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kontainer/apis/kontainer-api-documentation/docs/user-groups/:usergroup_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Retrieve Usergroup
    Endpoint for retrieving a specific usergroup.

## Path parameters

- `usergroup_id` string, required

## Response `200`

success

- UsergroupResponse
  - `data` Usergroup, required
    - `type` 'user_group', required
    - `id` string, required
    - `attributes` object, required
      - `name` string, required
      - `note` string, required
      - `active` boolean, required
      - `show_brand_section` 0 | 1, required: Stored flag returned uncast: `0` or `1` when the group is read back. Create and update responses echo the value that was submitted (a JSON boolean, `0`/`1` or `"0"`/`"1"`).
      - `hide_menu_by_default` boolean, required
      - `can_folder_share` boolean, required: Whether members may share folders externally. Written via `allow_folder_share`; always `false` while the client has external sharing disabled.
      - `can_internal_folder_share` boolean, required: Whether members may share folders internally. Written via `allow_internal_folder_share`.
      - `allow_cdn_activation_with_download_access` boolean, required
      - `is_sso_group` boolean, required: Whether the group is mapped to an SSO group name.

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/kontainer/apis/kontainer-api-documentation.md) - [All operations](https://skmtc.dev/kontainer/apis/kontainer-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kontainer/apis/kontainer-api-documentation/revisions/b80a5167e09a?raw)