---
title: "归档 Deployment"
method: POST
path: "/agent/managed/v1/deployments/{deploymentId}/archive"
tags: ["Managed Agents - Deployment"]
---

# 归档 Deployment

`POST /agent/managed/v1/deployments/{deploymentId}/archive`

## Request

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

归档指定 Deployment 并停止后续定时触发。归档是终态且操作幂等，重复归档不会刷新 `archived_at`；归档后不能更新、暂停、恢复或手动运行。Deployment 没有删除接口。

## Path parameters

- `deploymentId` string, required

## Headers

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

## Response `200`

请求成功。

- ManagedDeployment
  - `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。
            - object
              - …
            - object
              - …
            - object
              - …
  - `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: 更新时间。

## 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/:deploymentId/archive/post.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)