BIbigmodel
Channel

更新 Channel 配置

Changed on

局部更新 Channel 的群聊提示模板、飞书普通群话题开关或钉钉互动卡片配置。省略字段保留原值，不做配置整体替换。成功返回完整安全 Channel。

patch/agent/forward/v0/channels/{channelId}

Request

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

Path parameters

channelIdstring required

channelId 资源标识。

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

Response

请求成功。

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

      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

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      the request property / became optional

    • 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

  • 7fd61aa7f811Revision changes
    • info

      endpoint added