Skip to main content
Initiatives are the top-level work containers in OrgX. Use the REST preview to read portfolio state, progress, blockers, pending decisions, and active runs.

​
List Live Initiatives

GET /api/client/live/initiatives

curl "https://useorgx.com/api/client/live/initiatives?limit=10&offset=0" \
  -H "Authorization: Bearer $ORGX_API_KEY" \
  -H "Accept: application/json"

​
Query Parameters

ParameterTypeDescription
idstringOptional initiative ID filter.
limitintegerPage size. Maximum 50.
offsetintegerPage offset.

​
Response

{
  "initiatives": [
    {
      "id": "0e7c4df9-0f58-45a0-9c43-0ccf21b27a7d",
      "title": "Launch partner onboarding",
      "status": "active",
      "priority": "active",
      "progress": 42,
      "riskLevel": "medium",
      "workstreamCount": 4,
      "activeWorkstreams": 2,
      "blockedWorkstreams": 0,
      "pendingDecisions": 1,
      "activeRuns": 1,
      "failedRuns": 0,
      "updatedAt": "2026-04-29T20:00:00Z"
    }
  ],
  "total": 1,
  "pagination": {
    "limit": 10,
    "offset": 0,
    "has_more": false
  }
}

​
Create or Modify Initiatives

For creation and lifecycle writes during Public Preview, use MCP tools:
  • scaffold_initiative
  • batch_create_entities
  • orgx_act
  • orgx_recommend
REST write endpoints for initiatives will graduate after the preview contract is fully stabilized.