BIbigmodel
Channel

创建 Channel

Changed on

创建 Channel，将固定版本的 Agent 绑定到飞书、企业微信、钉钉或个人微信；201 仅表示保存成功，连接异步建立，凭据永不回显。

post/agent/forward/v0/channels

Request

  • Base URL
    https://agent-api.bigmodel.cn/api
  • Auth
    HTTP bearer

Headers

zai-version'2026-05-26' required
Example:2026-05-26

Channel API v0 基础协议标识，固定为 2026-05-26。

zai-betastring required
Example:managed-agents-2026-05-26

可有多个逗号分隔值，但必须包含 managed-agents-2026-05-26。

Request body

OR
OR
OR

Example request

{
  "channel_type": "feishu",
  "name": "飞书 Channel xxx",
  "template": {
    "agent": "agent_xxx",
    "environment_id": "env_xxx"
  },
  "channel_config": {
    "credentials": {
      "app_id": "xxx",
      "app_secret": "xxx"
    },
    "group_reply_in_thread": true
  }
}

Response

预检与配置保存成功，初始连接状态 disconnected；不代表可收发消息。

OR
OR
OR

Example response

{
  "id": "channel_feishu_xxx",
  "type": "channel",
  "channel_type": "feishu",
  "name": "飞书 Channel xxx",
  "template": {
    "agent": {
      "type": "agent",
      "id": "agent_xxx",
      "version": 3
    },
    "environment_id": "env_xxx",
    "vault_ids": [],
    "file_ids": [],
    "memory_stores": []
  },
  "enabled": true,
  "binding_status": "bound",
  "connection_status": "disconnected",
  "channel_config": {
    "response_options": {
      "include_tool_calls": false,
      "include_process": false,
      "card_output": true
    },
    "private_memory_store_enabled": false,
    "group_prompt_template": null,
    "group_reply_in_thread": true
  },
  "last_error": null,
  "created_at": "2026-10-30T00:00:00.000Z",
  "updated_at": "2026-10-30T00:00:00.000Z"
}

Changes

  • f2be7c0fcbb9Revision changes
    • breaking

      the request's body type changed from object to no type

    • breaking

      added to the response body oneOf list for the response status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      the optional response header Retry-After removed for the status 429

    • warning

      the optional response header Retry-After removed for the status 503

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      added request discriminator

    • info

      added to the request body oneOf list

    • info

      added response discriminator for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 7fd61aa7f811Revision changes
    • info

      endpoint added