Initiatives - OrgX Docs

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

Parameter	Type	Description
`id`	string	Optional initiative ID filter.
`limit`	integer	Page size. Maximum `50`.
`offset`	integer	Page 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.