---
title: "Get list of groups for the subchannel"
method: GET
path: "/channels/{channel_name}/subchannels/{subchannel_name}/groups"
tags: ["groups"]
---

# Get list of groups for the subchannel

`GET /channels/{channel_name}/subchannels/{subchannel_name}/groups`

## Request

- Base URL: `https://api.anaconda.cloud/api`
- URL: `https://api.anaconda.cloud/api/channels/{channel_name}/subchannels/{subchannel_name}/groups`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/anaconda/apis/anaconda-server-api/docs/channels/:channel_name/subchannels/:subchannel_name/groups/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `channel_name` string, required
- `subchannel_name` string, required

## Response `200`

successfully retrieved the channel attached groups

- object
  - `total_count` number
  - `items` ChannelGroup[]
    - `group_id` string: the assigned group_id
    - `name` string: the assigned group name
    - `description` string: the assigned group description
    - `permission` 'read' | 'write' | 'manage'
    - `persistent` boolean: the persistent groups could not be deleted
    - `created_at` string: when the group was created
    - `updated_at` string: when the group was updated

## Other responses

- `401`: Unauthenticated, no token is provided or token is invalid
- `403`: Access is forbidden
- `404`: The specified resource was not found
- `500`: Internal server error

---

[API](https://skmtc.dev/anaconda/apis/anaconda-server-api.md) - [All operations](https://skmtc.dev/anaconda/apis/anaconda-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anaconda/apis/anaconda-server-api/revisions/6aef0cb7a151?raw)