GetOptimizeRun
Queries the status, errors, execution progress, type-related results, and artifact references of a specified run.
Try it now
Test
RAM authorization
Request syntax
GET /agentspace/{agentSpace}/optimizetasks/{optimizeTaskName}/runs/{optimizeRunId} HTTP/1.1
Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| agentSpace |
string |
No |
The name of the AgentSpace. |
my-agent-space |
| optimizeTaskName |
string |
No |
The name of the optimization task. |
efficiency-analysis |
| optimizeRunId |
string |
No |
The ID of the execution instance. |
or-20260812-0001 |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
No parameters required.
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The execution details of the optimization task. |
||
| attemptCount |
integer |
The number of executed attempts. |
1 |
| createTime |
string |
The creation time. |
2026-08-12T10:00:00Z |
| currentStage |
string |
The current execution stage. |
attribution |
| errorCode |
string |
The error code. |
InternalError |
| errorMessage |
string |
The error message. |
The optimize run failed. |
| extra |
object |
The type-related information and immutable result references. For efficiency analysis, frozen outputBindings and tokenPublication release receipts are returned. |
|
|
any |
The value of a single field in the run type-related information. For example, preview indicates whether the run is a pre-run. |
false |
|
| finishTime |
string |
The completion time. |
2026-08-12T10:01:00Z |
| maxAttempts |
integer |
The maximum number of attempts. |
3 |
| optimizeRunId |
string |
The ID of the execution instance. |
or-20260812-0001 |
| optimizeTaskName |
string |
The name of the optimization task. |
efficiency-analysis |
| progress |
object |
The current execution progress. The fields are defined by the task type. |
|
|
any |
The value of a single field in the current execution progress. The fields are defined by the task type. This object can be empty if no progress information is provided. |
{} |
|
| requestId |
string |
The request ID. |
9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M |
| startTime |
string |
The initial start time. |
2026-08-12T10:00:01Z |
| status |
string |
The execution status. |
Succeeded |
| trajectoryCount |
integer |
The number of analysis trajectories. |
100 |
| triggerType |
string |
The trigger type. |
Scheduled |
| type |
string |
The task type snapshot. |
EfficiencyAnalysis |
| windowEndTime |
integer |
The end time of the analysis window, in UNIX seconds. |
1786432690000 |
| windowStartTime |
integer |
The start time of the analysis window, in UNIX seconds. |
1786432688000 |
Examples
Success response
JSON format
{
"attemptCount": 1,
"createTime": "2026-08-12T10:00:00Z",
"currentStage": "attribution",
"errorCode": "InternalError",
"errorMessage": "The optimize run failed.",
"extra": {
"key": "false"
},
"finishTime": "2026-08-12T10:01:00Z",
"maxAttempts": 3,
"optimizeRunId": "or-20260812-0001",
"optimizeTaskName": "efficiency-analysis",
"progress": {
"key": "{}"
},
"requestId": "9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M",
"startTime": "2026-08-12T10:00:01Z",
"status": "Succeeded",
"trajectoryCount": 100,
"triggerType": "Scheduled",
"type": "EfficiencyAnalysis",
"windowEndTime": 1786432690000,
"windowStartTime": 1786432688000
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.