Skip to main content
GET
/
v1
/
boards
/
{id}
curl https://api.chatgrid.ai/v1/boards/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer cgk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

{
  "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"
  }
}
​
id
string
required
Board UUID.
Returns the full board including flow_state for boards you own. Public boards return a lightweight view without flow_state. 
curl https://api.chatgrid.ai/v1/boards/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer cgk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

{
  "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"
  }
}