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

workspace_id

string

Must match verified runtime claims.

skill_id

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.

X-MOI-Skill-Version

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.

Last updated on