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

# Get Board

> Retrieves a board by ID, including full flow state for boards you own.

Returns the full board including `flow_state` for boards you own. Public boards
return a lightweight view without `flow_state`.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.chatgrid.ai/v1/boards/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
    -H "Authorization: Bearer cgk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "board",
    "data": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Q1 Marketing Plan",
      "flow_state": {
        "viewMode": "canvas",
        "nodes": [],
        "edges": [],
        "viewport": { "x": 0, "y": 0, "zoom": 1 }
      },
      "viewport_x": 0,
      "viewport_y": 0,
      "viewport_zoom": 1,
      "is_public": false,
      "public_access_level": null,
      "created_at": "2026-03-15T10:30:00.000Z",
      "updated_at": "2026-03-15T12:45:00.000Z"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "object": "error",
    "status": 404,
    "code": "not_found",
    "message": "Board not found"
  }
  ```
</ResponseExample>