BIbigmodel
Channel

列出 Channel

Changed on

分页列出当前账号的四类公开 Channel，data[] 可以混合返回 Feishu、WeCom、DingTalk、WeChat。不提供渠道平台、Agent 或状态过滤。

get/agent/forward/v0/channels

Request

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

Query parameters

limitinteger

每页数量。

order'asc' | 'desc'

排序方向。

pagestring

上一页返回的不透明游标；不能解析或自行拼接。next_page 只表示当前排序方向的下一页。

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。

Response

请求成功。

next_pagestring nullable required

当前排序方向的下一页不透明游标；没有下一页为 null。不得解析或自行拼接。

Example response

{
  "data": [
    {
      "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"
    },
    {
      "id": "channel_wecom_xxx",
      "type": "channel",
      "channel_type": "wecom",
      "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
      },
      "last_error": null,
      "created_at": "2026-10-30T00:00:00.000Z",
      "updated_at": "2026-10-30T00:00:00.000Z"
    },
    {
      "id": "channel_dingtalk_xxx",
      "type": "channel",
      "channel_type": "dingtalk",
      "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,
        "card_template_id": "xxx.schema",
        "card_content_key": "content"
      },
      "last_error": null,
      "created_at": "2026-10-30T00:00:00.000Z",
      "updated_at": "2026-10-30T00:00:00.000Z"
    },
    {
      "id": "channel_wechat_xxx",
      "type": "channel",
      "channel_type": "wechat",
      "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": "unbound",
      "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
      },
      "last_error": null,
      "created_at": "2026-10-30T00:00:00.000Z",
      "updated_at": "2026-10-30T00:00:00.000Z"
    }
  ],
  "next_page": null
}

Changes

  • f2be7c0fcbb9Revision changes
    • breaking

      added to the / response property oneOf list for the response status

    • breaking

      the / response's property 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 non-success response with the status

    • info

      added discriminator to / response property for the response status

  • 7fd61aa7f811Revision changes
    • info

      endpoint added