Get an agent artifact version¶
Read an accessible file and its provenance by artifact ID and version.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-artifacts/{artifact_id}/versions/{version}
Before you call this API¶
Set BASE_URL to the product API prefix https://api.moi.matrixorigin.cn/v5; use the corresponding product API URL for a dedicated deployment.
Prepare identity, volume permissions, and version references.
Request¶
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-artifacts/$ARTIFACT_ID/versions/$ARTIFACT_VERSION" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
Parameter |
Location |
Type |
Required |
Description |
|---|---|---|---|---|
|
Path |
string |
Yes |
Workspace ID in the current environment. |
|
Path |
string |
Yes |
Artifact ID returned by the list. |
|
Path |
integer |
Yes |
Positive integer version returned by the list. Do not substitute a file ID. |
The read also requires artifact status completed, an active source conversation, an unarchived Agent, and an accessible readable mount. The result is metadata, not file bytes. Source fields may be empty when the original source cannot be shown to the current user.
Successful response¶
{
"code": 0,
"data": {
"workspace_id": "workspace-example",
"artifact_id": "artifact-example",
"version": 1,
"artifact_kind": "file",
"status": "completed",
"file_id": "file-example",
"placement_id": 23,
"volume_id": 10,
"file_path": "reports/summary.txt",
"file_name": "summary.txt",
"content_type": "text/plain",
"file_category": "document",
"size": 128,
"md5": "0123456789abcdef0123456789abcdef",
"agent_workspace_id": "workspace-example",
"agent_id": "agent-example",
"agent_name": "资料助手",
"conversation_id": "conversation-example",
"conversation_title": "资料整理",
"task_id": "task-example",
"call_id": "call-example",
"tool_id": "tool-example",
"created_by": "user-example",
"creator_name": "示例用户",
"source_event_id": "event-example",
"source_event_seq": 3,
"generated_at": "2026-11-12T01:00:00Z",
"created_at": "2026-11-12T01:00:00Z",
"updated_at": "2026-11-12T01:00:00Z"
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success; batch actions still require checking individual results. |
|
object |
Error responses¶
Errors and result confirmation distinguishes whole-request failure, item-level failure, and invisible provenance.