> ## 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.

# Create Board

> Creates a new board. Defaults to canvas view mode.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.chatgrid.ai/v1/boards \
    -H "Authorization: Bearer cgk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6" \
    -H "Content-Type: application/json" \
    -d '{"name": "Q1 Marketing Plan", "view_mode": "canvas"}'
  ```

  ```typescript Node.js theme={null}
  const response = await fetch("https://api.chatgrid.ai/v1/boards", {
    method: "POST",
    headers: {
      Authorization: "Bearer cgk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ name: "Q1 Marketing Plan", view_mode: "canvas" }),
  });
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "object": "board",
    "data": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Q1 Marketing Plan",
      "created_at": "2026-03-15T10:30:00.000Z",
      "updated_at": "2026-03-15T10:30:00.000Z",
      "is_public": false,
      "public_access_level": null,
      "viewport_x": 0,
      "viewport_y": 0,
      "viewport_zoom": 1
    }
  }
  ```
</ResponseExample>