Get latest published workflow version¶
Reads details of the version in published status with the highest version number for the specified workflow. Returns 404 (ErrNotFound) when the workflow currently has no published version.
GET https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/{workflow_id}/versions/latest-published
Before you begin¶
Prepare a personal access token with workflow version read permission and the target workspace ID.
Call List workflows to obtain the target workflow ID; if you need to check whether any published version exists first, call List workflow versions.
Request parameters¶
Replace $AI_STUDIO_API_KEY, $WORKSPACE_ID, and $WORKFLOW_ID with actual values.
curl "https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/$WORKFLOW_ID/versions/latest-published" \
-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. |
Successful response¶
Returns HTTP 200 and the latest published 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 |
Latest published 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; fixed to |
|
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, has no bound workflow definition, or currently has no version in published status. If only draft or deprecated versions exist, call List workflow versions to inspect all version statuses.
{
"code": "ErrNotFound",
"msg": "Not Found"
}
Field |
Type |
Description |
|---|---|---|
|
string |
Error code, such as |
|
string |
Human-readable error message. |