---
title: "Add a group channel"
method: POST
path: "/api/group/{group}/channel/"
tags: ["group-channel"]
---

# Add a group channel

`POST /api/group/{group}/channel/`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`

Adds a group channel to a specific group and atomically creates the group when it does not exist. Existing group configuration is preserved.

## Path parameters

- `group` string, required

## Request body

- ControllerAddGroupChannelRequest
  - `backup_only` boolean
  - `base_url` string
  - `configs` ModelChannelConfigs
  - `enabled_no_permission_ban` boolean
  - `group_id` string
  - `key` string
  - `max_error_rate` number
  - `model_mapping` object
  - `models` string[]
  - `name` string
  - `priority` integer
  - `proxy_url` string
  - `remark` string
  - `sets` string[]
  - `skip_tls_verify` boolean
  - `status` integer
  - `type` 1 | 3 | 4 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59
  - `warn_error_rate` number

## Response `200`

OK

- MiddlewareAPIResponse
  - `data` unknown
  - `message` string
  - `success` boolean

## Changes

- **2026-10-12** `c2f7f35df2f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/labring/apis/ai-proxy-swagger-api/changes/api/group/:group/channel/post.md)

---

[API](https://skmtc.dev/labring/apis/ai-proxy-swagger-api.md) - [All operations](https://skmtc.dev/labring/apis/ai-proxy-swagger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/labring/apis/ai-proxy-swagger-api/revisions/c2f7f35df2f5?raw)