Get workflow version details¶
Reads details of a single workflow version by its version ID. The server verifies that the version belongs to the same workflow definition and owner as the target workflow.
GET https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/{workflow_id}/versions/{version_id}
Before you begin¶
Prepare a personal access token with workflow version read permission and the target workspace ID.
Call List workflow versions to obtain
ID, or readlatest_workflow_version_idfrom Get workflow details.
Request parameters¶
Replace $AI_STUDIO_API_KEY, $WORKSPACE_ID, $WORKFLOW_ID, and $VERSION_ID with actual values.
curl "https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/$WORKFLOW_ID/versions/$VERSION_ID" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID"
Path parameters
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes |
Target workflow ID, obtained from List workflows. |
|
string |
Yes |
Target workflow version ID, obtained from |
Successful response¶
Returns HTTP 200 and the requested workflow version object. Version object keys use PascalCase on the JSON wire.
{
"code": "OK",
"msg": "OK",
"data": {
"ID": "ver-001",
"WorkspaceID": "ws-001",
"UserID": "user-001",
"WorkflowDefinitionID": "def-001",
"Version": 1,
"WorkflowJSON": "{\"name\":\"daily-import\",\"nodes\":[]}",
"Status": "published",
"CreatedBy": "user-001",
"CreatedAt": "2026-10-14T08:00:00Z",
"PublishedAt": "2026-10-14T08:05:00Z",
"Type": 1,
"InputSchema": "",
"OutputSchema": "",
"ResultMode": 0,
"Description": "Initial published version",
"RuntimeSpecJSON": ""
}
}
Field |
Type |
Description |
|---|---|---|
|
string |
|
|
string |
Result message; |
|
object |
Requested workflow version object. |
|
string |
Workflow version ID. |
|
string |
Workspace ID that owns the version. |
|
string |
User ID of the workflow owner. |
|
string |
Workflow definition ID that owns the version. |
|
integer |
Positive integer version number starting from |
|
string |
Saved workflow definition JSON string. |
|
string |
Version status: |
|
string |
User ID of the actor who created the version. |
|
string |
Version creation time in RFC 3339 format. |
|
string |
Version publication time in RFC 3339 format; |
|
integer |
Version type code: |
|
string |
Saved input schema JSON string; |
|
string |
Saved output schema JSON string; |
|
integer |
Result mode code: |
|
string |
Version description; |
|
string |
Saved runtime specification JSON string; |
Error response¶
Returns 404 (ErrNotFound) when the workflow does not exist, the version does not exist, or the version does not belong to the target workflow definition.
{
"code": "ErrNotFound",
"msg": "Not Found"
}
Field |
Type |
Description |
|---|---|---|
|
string |
Error code, such as |
|
string |
Human-readable error message. |