---
title: "Add multiple group channels"
method: POST
path: "/api/group_channels/"
tags: ["group_channels"]
---

# Add multiple group channels

`POST /api/group_channels/`

## Request

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

Adds group channels from the global management view and atomically creates missing groups. Existing group configuration is preserved. Each request item must include group_id.

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