# 发布子任务文件产物

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

将当前受管子任务生成的文件保存到所属用户的聊天文件卷，并发布任务产物。

```text
POST https://api.moi.matrixorigin.cn/v5/workspaces/{id}/runtime-artifacts
```

## 调用前准备

`BASE_URL` 使用产品 API 前缀 `https://api.moi.matrixorigin.cn/v5`；专有部署填写对应的产品 API 地址。

在受管子环境使用MOI_ENDPOINT、MOI_API_KEY、MOI_RUNTIME_AUTHORIZATION和MOI_WORKSPACE_ID同一连接组。BASE_URL取MOI_ENDPOINT、WORKSPACE_ID取MOI_WORKSPACE_ID；MOI_RUNTIME_AUTHORIZATION已经包含Bearer前缀。普通PAT不能代替子任务身份。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl --fail-with-body -sS -X POST "$BASE_URL/workspaces/$WORKSPACE_ID/runtime-artifacts" \
  -H "X-API-Key: $MOI_API_KEY" \
  -H "X-MOI-Runtime-Authorization: $MOI_RUNTIME_AUTHORIZATION" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -F "file=@$ARTIFACT_FILE"
```

:::::
:::::{tab-item} 参数说明

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `file` | file | 是 | 非空文件，单个文件最多32MiB；文件名为不带路径的名称，最多255字节。 |

只使用当前子环境的一组技术API key、运行证明与工作区，且证明必须允许产物发布。没有该能力的图像分析证明不能代用。先检查agent.use及卷写入权限，再读取上传体；保存时重复写入授权。

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "file_id": "file-example",
  "original_name": "report.txt",
  "size": 7,
  "md5": "a9346fbaf920e99acc512e8dcc57fa3c",
  "artifact_id": "artifact-example",
  "sha256": "sha256:331d26d6d8f862e46ba900811be8a7a1e4dbaa229b14c99becfd5e5151490d95"
}
```

:::::
:::::{tab-item} 字段说明

| 字段／响应项 | 类型 | 说明 |
| --- | --- | --- |
| `file_id` | string | 用于文件读取的ID。 |
| `original_name` | string | 保存的文件名。 |
| `size` | integer | 文件字节数。 |
| `md5` | string | 内容MD5。 |
| `artifact_id` | string | 任务产物ID，与file_id分开。 |
| `sha256` | string | 带sha256:前缀的内容摘要。 |

成功响应没有统一code/data外层；临时文件和图片流直接返回字节。

:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "error_code": "runtime_artifact_upload_denied"
}
```

:::::
:::::{tab-item} 字段说明

| HTTP | code／形式 | 条件 |
| --- | --- | --- |
| 400 | 数值2/message | 路径与唯一工作区请求头不一致。 |
| 400 | runtime_artifact_file_required | 没有可用非空file部分。 |
| 400 | runtime_artifact_upload_denied | 文件名、产物输入或任务不符合发布条件。 |
| 403 | runtime_artifact_upload_denied | 产物能力或授权拒绝。 |
| 413 | runtime_artifact_upload_denied | 超过文件或请求上限。 |
| 404 | runtime_artifact_upload_denied | 必要文件或业务对象不存在。 |
| 503 | runtime_artifact_upload_unavailable | 依赖或发布不可用。 |

外层身份／任务证明的拒绝还可能先于此handler；保持原始HTTP、机器码与实际诊断，不套其他文件协议错误包。

:::::
::::::
:::::::
