> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorgx.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Initiatives

> Read live initiative state through the OrgX REST Public Preview.

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

```http theme={"dark"}
GET /api/client/live/initiatives
```

```bash theme={"dark"}
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

```json theme={"dark"}
{
  "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.