---
title: "Update group subchannel permission"
method: PUT
path: "/channels/{channel_name}/subchannels/{subchannel_name}/groups/{group_id}"
tags: ["groups"]
---

# Update group subchannel permission

`PUT /channels/{channel_name}/subchannels/{subchannel_name}/groups/{group_id}`

## Request

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

## Path parameters

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

## Request body

- ChannelGroupPermissions: group members permissions to channel
  - `permission` 'read' | 'write' | 'manage', required

## Response `200`

successfully updated the subchannel group permissions

- 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
- `409`: Creating/updating resource raises a conflict
- `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)