CreateOptimizeRun
Try it now
Test
RAM authorization
Request syntax
POST /agentspace/{agentSpace}/optimizetasks/{optimizeTaskName}/runs HTTP/1.1Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| agentSpace |
string |
No |
The AgentSpace name. |
my-agent-space |
| optimizeTaskName |
string |
No |
The name of the optimization task. |
experience-mining |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| clientToken |
string |
No |
The idempotency token. Use the same value when you retry the same creation request. |
a1b2c3d4-1234-5678-90ab-cdef12345678 |
| body |
object |
No |
The run input and pre-run options. |
|
| input |
any |
Yes |
The JSON input defined by the task type, preserving the original object or array structure. ExperienceMining accepts a start/end/processTimeMaxNS object. SkillOptimize accepts an inline input array, a skills/window object for SLS, or a skills/records object for ATIF or xTrace. The server validates the input based on the task type and configuration. Memory extraction continues to use the original ContextStore API. |
{"start":1727136000,"end":1727139600,"processTimeMaxNS":1727139600000000000} |
| preview |
boolean |
No |
Specifies whether to execute an independent pre-run of the complete algorithm. The pre-run generates candidate results and evidence without publishing them to the target dataset or advancing the formal run history. A formal run executes the algorithm independently. |
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response for creating an optimization task run. |
||
| requestId |
string |
The request ID. |
9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M |
| optimizeRunId |
string |
The run ID. |
opr-20261014 |
| optimizeRun |
object |
The details of the created run. You can call the GetOptimizeRun operation to query the subsequent status. |
{"optimizeRunId":"opr-20261014","status":"Pending"} |
|
any |
The value of a single field in the run details. For example, the value of the status field is Pending. |
Pending |
Examples
Success response
JSON format
{
"requestId": "9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M",
"optimizeRunId": "opr-20261014",
"optimizeRun": {
"key": "Pending"
}
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.