---
title: "Add a new group to the subchannel"
method: POST
path: "/channels/{channel_name}/subchannels/{subchannel_name}/groups"
tags: ["groups"]
---

# Add a new group to the subchannel

`POST /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/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

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

## Request body

- ChannelGroupRequest
  - `group_id` string, required: group_id to add
  - `permission` 'read' | 'write' | 'manage', required

## Response `204`

successfully added group to the subchannel

## 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)