Planning endpoint

Retrieve Planning Candidate

GET/planning-sessions/{sessionId}/candidates/{candidateId}/

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}" \
  "${AKOFLOW_API_URL}/planning-sessions/{sessionId}/candidates/{candidateId}/"

Replace the path identifiers with IDs from your instance.

200 OKapplication/json

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

{
  "id": "string",
  "planningSessionId": "string",
  "algorithmRunId": "string",
  "algorithm": "string",
  "objective": "string",
  "rank": 0,
  "paretoOptimal": true,
  "dominated": true,
  "feasible": true,
  "predicted": {
    "makespanSeconds": 0,
    "cost": 0,
    "feasible": true
  },
  "plan": {
    "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": [],
    "lifecycleActions": [],
    "assignmentCount": 0,
    "metadata": {}
  },
  "fingerprint": "string",
  "createdAt": "2026-01-01T00:00:00Z"
}

Related guide

See the Planning guide for related tasks and context.