Planning endpoint

List Planning Candidates

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

Path parameters

sessionId

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/"

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": {},
      "assignments": [],
      "lifecycleActions": [],
      "assignmentCount": 0,
      "metadata": {}
    },
    "fingerprint": "string",
    "createdAt": "2026-01-01T00:00:00Z"
  }
]

Related guide

See the Planning guide for related tasks and context.