---
title: "列出 Deployment"
method: GET
path: "/agent/managed/v1/deployments"
tags: ["Managed Agents - Deployment"]
---

# 列出 Deployment

`GET /agent/managed/v1/deployments`

## Request

- Base URL: `https://agent-api.bigmodel.cn/api`
- URL: `https://agent-api.bigmodel.cn/api/agent/managed/v1/deployments`
- Auth: HTTP bearer

分页列出可访问的 Deployment，支持按 Agent、状态和创建时间筛选。

<Accordion title="使用说明">

分页列出当前身份可读取的 Deployment，支持按 Agent、状态和创建时间过滤。默认不返回已归档记录；传入 `include_archived=true` 可包含已归档 Deployment。归档状态由 `archived_at` 表示，`status` 仍只会是 `active` 或 `paused`。

</Accordion>

## Query parameters

- `agent_id` string
- `status` 'active' | 'paused'
- `created_at[gte]` string, date-time
- `created_at[lte]` string, date-time
- `include_archived` boolean
- `limit` integer
- `order` 'asc' | 'desc'
- `page` string

## Headers

- `zai-version` '2026-05-26', required
- `zai-beta` string, required

## Response `200`

请求成功。

- ManagedDeploymentPage
  - `data` ManagedDeployment[], required
    - `id` string, required
    - `type` 'deployment', required
    - `name` string, required
    - `agent` ManagedDeploymentAgent, required
      - `type` 'agent', required
      - `id` string, required
      - `version` integer, required
    - `environment_id` string, required: Deployment 绑定的 Environment ID。旧数据缺失该字段时可能返回内部兼容值 `env_default`。
    - `description` string, nullable, required: 用途说明。
    - `metadata` ManagedMetadata, required: 客户端自定义元数据；省略时默认为空对象。最多 16 个键，键名长度不超过 64 字符，值必须是长度不超过 512 字符的字符串。
    - `resources` ManagedDeploymentResourceInput[], required
      - union
        - object
          - `type` 'memory_store', required: 固定为 memory_store。
          - `memory_store_id` string, required: Agent 所有者名下处于 active 状态的 Memory Store ID。
          - `access` 'read_only' | 'read_write': 挂载权限；省略时由 Memory 服务按 read_write 处理。
          - `instructions` string: 提供给 Agent 的使用说明；省略时不设置。
        - object
          - `type` 'file', required: 固定为 file。
          - `file_id` string, required: 已存在且归当前资源所有者所有的 File ID。
          - `mount_path` string, nullable: 沙箱内挂载路径；省略或传 null 时默认为 /mnt/session/uploads/{file_id}。路径会归一化到 /mnt/session/uploads 下，不能逃逸该目录，UTF-8 总长度不超过 1024 字节。
    - `schedule` ManagedScheduleResponse, required
      - `type` 'cron', required
      - `expression` string, required
      - `timezone` 'Asia/Shanghai', required
      - `last_run_at` string, nullable, required: 上次运行时间。
      - `upcoming_runs_at` string[], required: 即将触发的计划时间。下次运行看数组第一项；manual-only 时整个 schedule 为 null。
    - `initial_events` ManagedDeploymentInitialEvent[], required
      - `type` 'user.message', required: 固定为 user.message。
      - `content` ManagedInitialContentBlock[], required: 非空内容块数组；初始消息允许 text/image，普通消息还允许 document。图片最多 50 张；总量受请求体限制。
        - union
          - object
            - `type` 'text', required: 固定为 text。
            - `text` string, required: 非空文本内容。
          - object
            - `type` 'image', required: 固定为 image。
            - `source` union, required: 图片来源为 base64、url 或 file。每事件最多 50 张，单张最多 50 MiB；1–20 张时宽高各不超过 8000 px，21–50 张时各不超过 2000 px。图片 Base64 总量最多 112 MiB，带图请求体最多 128 MiB。
              - …
    - `status` 'active' | 'paused', required
    - `paused_reason` union, required
      - object
        - `type` 'manual', required
      - object
        - `type` 'error', required
        - `error` object, required
          - `type` 'environment_archived_error' | 'environment_not_found_error' | 'file_not_found_error' | 'memory_store_archived_error' | 'vault_archived_error' | 'vault_not_found_error', required
    - `vault_ids` string[], required
    - `archived_at` string, nullable, required: 归档时间。
    - `created_at` string, date-time, required: 创建时间。
    - `updated_at` string, date-time, required: 更新时间。
  - `next_page` string, nullable, required

## Other responses

- `default`: 请求失败。

## Changes

- **2026-11-03** `7fd61aa7f811`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/changes/agent/managed/v1/deployments/get.md)

---

[API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)