Planning endpoint

Select Planning Candidate

POST/planning-sessions/{sessionId}/candidates/{candidateId}/select/

Path parameters

sessionId

Identifier used by the registered route.

candidateId

Identifier used by the registered route.

Request body

none

This endpoint does not accept a request body.

cURL template

curl --fail-with-body \
  -H "Authorization: Bearer ${AKOFLOW_API_TOKEN}" \
  -X POST \
  "${AKOFLOW_API_URL}/planning-sessions/{sessionId}/candidates/{candidateId}/select/"

Replace the path identifiers with IDs from your instance.

201 Createdapplication/json

Field shape inferred from Go types; inspect the returned JSON for actual values and optional fields.

{
  "id": "string",
  "workflowVersionId": "string",
  "executionScopeId": "string",
  "networkTopologyId": "string",
  "source": "string",
  "algorithm": "string",
  "algorithmVersion": "string",
  "objective": "string",
  "deadlineSeconds": 0,
  "budget": 0,
  "predicted": {
    "makespanSeconds": 0,
    "cost": 0,
    "feasible": true
  },
  "assignments": [
    {
      "id": "string",
      "planId": "string",
      "activityId": "string",
      "resourceId": "string",
      "coreId": "string",
      "slotId": "string",
      "orderOnResource": 0,
      "priority": 0,
      "predictedReadyAt": 0,
      "predictedStartAt": 0,
      "predictedFinishAt": 0,
      "predictedRuntimeSeconds": 0,
      "predictedTransferSeconds": 0,
      "predictedCost": 0,
      "metadata": {}
    }
  ],
  "lifecycleActions": [
    {
      "id": "string",
      "schedulePlanId": "string",
      "capacityTargetId": "string",
      "cloudInstanceId": "string",
      "action": "string",
      "earliestStart": 0,
      "expectedDuration": 0,
      "dependsOn": [
        "string"
      ],
      "metadata": {}
    }
  ],
  "assignmentCount": 0,
  "metadata": {}
}

Handler-checked behavior

The candidate must belong to this session and be feasible. No JSON body is required. A successful selection returns the saved schedule plan with 201 Created and records the selected IDs on the session. The API permits selecting before the session completes; wait for final ranking unless choosing an early candidate intentionally.

Related guide

See the Planning guide for related tasks and context.