---
title: "The board's structure"
method: GET
path: "/boards/{boardId}/structure"
tags: ["Boards"]
---

# The board's structure

`GET /boards/{boardId}/structure`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/boards/{boardId}/structure`
- Auth: HTTP bearer

The machine view behind the outline. Sections by geometry with their items and per-type counts, groups, and connector edges with labels.

## Response `200`

OK

- Structure
  - `boardId` string
  - `title` string
  - `counts` object
  - `sections` object[]
    - `id` string
    - `title` string
    - `position` Point
      - `x` number, required
      - `y` number, required
    - `size` Size
      - `width` number
      - `height` number
    - `counts` object
    - `children` OutlineNode[]
      - `id` string
      - `type` string
      - `title` string
      - `text` string
  - `standalone` OutlineNode[]
    - `id` string
    - `type` string
    - `title` string
    - `text` string
  - `groups` object[]
    - `id` string
    - `itemIds` string[]
  - `edges` object[]
    - `id` string
    - `from` string, nullable
    - `to` string, nullable
    - `fromTitle` string, nullable
    - `toTitle` string, nullable
    - `directed` boolean
    - `label` string

## Other responses

- `429`: Too many requests.
- `4XX`: An error. See the envelope and the code list on the Errors page.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)