Download skill files bound to a runtime as ZIP¶
Download files at the skill version frozen by the current trusted runtime. The version comes from verified runtime claims, not URL parameters or the current skill version.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/skills/{skill_id}/runtime-files
Before you call this API¶
Set MOI_ENDPOINT to the product API prefix https://api.moi.matrixorigin.cn/v5. For private deployments, use the corresponding product API URL.
Applies only to child runtime environments already admitted by the product. Use Endpoint, technical API Key, Workspace, and X-MOI-Runtime-Authorization supplied together by that environment. The latter is the complete Bearer line; do not replace it with a personal access token or short-lived browser proof.
Request parameters¶
curl --fail-with-body "$MOI_ENDPOINT/workspaces/$MOI_WORKSPACE_ID/skills/$SKILL_ID/runtime-files" \
-H "X-API-Key: $MOI_API_KEY" \
-H "X-Workspace-ID: $MOI_WORKSPACE_ID" \
-H "X-MOI-Runtime-Authorization: $MOI_RUNTIME_AUTHORIZATION" \
--output skill-files.zip
Parameter |
Type |
Description |
|---|---|---|
|
string |
Must match verified runtime claims. |
|
string |
Skill bound in claims with one positive version. |
Query parameters |
Not accepted |
Nonempty RawQuery is rejected; version/source workspace cannot be supplied. |
Runtime claims |
Trusted context |
The backend confirms binding, source limited to current workspace/system, and one frozen version. |
Successful response¶
HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename=skill-files.zip
X-MOI-Skill-Version: 7
Cache-Control: private, no-store
X-Content-Type-Options: nosniff
<ZIP二进制字节>
Field or response item |
Type |
Description |
|---|---|---|
Response body |
ZIP bytes |
Neither a JSON envelope nor plaintext for one file. |
|
HTTP header |
Actual frozen version. Example7 is not caller-selected. |
File source |
Protocol behavior |
Reads the frozen version and verifies paths/sizes/digests. Current-version updates do not replace the snapshot. |
Error response¶
Missing claims, unbound skills, invalid source/version/workspace, or query parameters may return 403; missing frozen versions/files404. Skill errors follow current mappings. A mock successful regular-PAT download does not verify actual admission.