---
title: "List All Boards"
method: GET
path: "/1/boards"
tags: ["Boards"]
---

# List All Boards

`GET /1/boards`

Retrieves a list of all non-secret Boards within an environment. **Note**: For Honeycomb Classic users, all boards within Classic will be returned.

## Response `200`

Success

- Board[]
  - `name` string, required — The name of the Board.
  - `description` string — A description of the Board.
  - `type` 'flexible', required — The type of the board. Only flexible boards are supported.
  - `links` object
    - `board_url` string
  - `id` string — Unique identifier (ID), returned in response bodies.
  - `panels` BoardPanel[]
    - union
      - object
        - `type` 'query', required — The type of the board panel.
        - `position` BoardPanelPosition — The position of the panel within the layout. When X and Y coordinates are not specified for any of the panels, the layout will be generated automatically.
          - `x_coordinate` integer — The x-axis origin point for placing the panel within the layout.
          - `y_coordinate` integer — The y-axis origin point for placing the panel within the layout.
          - `height` integer — The height of the panel. When not specified or set to 0, the height of the panel is calculated dynamically based on the panel type.
          - `width` integer — The width of the panel. When not specified or set to 0, the width of the panel is calculated dynamically based on the panel type.
        - `query_panel` object, required
          - `query_id` string, required — The ID of the Query to display on the board. The Query must be in the same environment as the board.
          - `query_style` 'graph' | 'table' | 'combo' — How the query should be displayed on the board.
          - `query_annotation_id` string, required — The ID of a Query Annotation that provides a name and description for the Query. The Query Annotation must apply to the `query_id` or `query` specified.
          - `dataset` string — The dataset name to which the query is scoped. Empty for environment-wide queries.
          - `visualization_settings` BoardQueryVisualizationSettings — A map of values to control the display settings for the Query on the Board. Unspecified boolean values are assumed to be `false`. Unspecified integers are assumed to be `0`, unspecified arrays are assumed to be null and unspecified strings are assumed to be empty. This is incompatible with the `graph_settings` field.
            - `hide_compare` boolean
            - `hide_hovers` boolean
            - `hide_markers` boolean
            - `utc_xaxis` boolean
            - `overlaid_charts` boolean
            - `charts` object[]
              - …
      - object
        - `type` 'slo', required — The type of the board panel.
        - `position` BoardPanelPosition — The position of the panel within the layout. When X and Y coordinates are not specified for any of the panels, the layout will be generated automatically.
          - `x_coordinate` integer — The x-axis origin point for placing the panel within the layout.
          - `y_coordinate` integer — The y-axis origin point for placing the panel within the layout.
          - `height` integer — The height of the panel. When not specified or set to 0, the height of the panel is calculated dynamically based on the panel type.
          - `width` integer — The width of the panel. When not specified or set to 0, the width of the panel is calculated dynamically based on the panel type.
        - `slo_panel` object, required
          - `slo_id` string — The ID of the SLO to display on the board. The SLO must be in the same environment as the board.
      - object
        - `type` 'text', required — The type of the board panel.
        - `position` BoardPanelPosition — The position of the panel within the layout. When X and Y coordinates are not specified for any of the panels, the layout will be generated automatically.
          - `x_coordinate` integer — The x-axis origin point for placing the panel within the layout.
          - `y_coordinate` integer — The y-axis origin point for placing the panel within the layout.
          - `height` integer — The height of the panel. When not specified or set to 0, the height of the panel is calculated dynamically based on the panel type.
          - `width` integer — The width of the panel. When not specified or set to 0, the width of the panel is calculated dynamically based on the panel type.
        - `text_panel` object, required
          - `content` string, required — The text content to display on the board panel. This field supports Markdown formatting.
  - `layout_generation` 'auto' | 'manual' — The layout generation mode for the board. When set to "auto", the board will be automatically laid out based on the panels. When set to "manual", the board will be laid out manually by the user.
  - `tags` Tag[] — A list of key-value pairs to help identify the Trigger.
    - `key` string, required — A key to identify the tag, lowercase letters only.
    - `value` string, required — A value for the tag, must begin with a lowercase letter, contain only alphanumeric characters (all letters lowercase) and special characters of `/` and `-` allowed.
  - `preset_filters` PresetFilter[] — A list of preset filters to apply to the board. For backwards compatibility, if no preset filters are provided, the existing preset filters will be preserved. If an empty array is provided, all preset filters will be deleted. **Note**: Each board is limited to a maximum of 5 preset filters. Attempting to create or update a board with more than 5 preset filters will result in an error.
    - `column` string, required — Original name of the column to alias.
    - `alias` string, required — The alias of the preset filter. Maximum length is 50 characters.

## Other responses

- `401` — Unauthorized
- `429` — Rate Limit Exceeded
- `default` — Error

---

[API](https://skmtc.net/honeycomb/apis/honeycomb-api.md) · [All operations](https://skmtc.net/honeycomb/apis/honeycomb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/honeycomb/honeycomb-api/versions/117619fac2a5/schema)