curl --request POST \
--url https://api.honeycomb.io/1/boards \
--header 'Content-Type: application/json' \
--header 'X-Honeycomb-Team: <api-key>' \
--data '
{
"name": "My API Board",
"description": "A board created via the API with mixed panel types",
"type": "flexible",
"panels": [
{
"type": "query",
"query_panel": {
"query_id": "abc1234e",
"query_annotation_id": "e4c24a35"
},
"position": {
"x_coordinate": 0,
"y_coordinate": 0,
"height": 6,
"width": 8
}
},
{
"type": "text",
"text_panel": {
"content": "# Welcome to our API Dashboard\n\nThis board shows key metrics for our services."
},
"position": {
"x_coordinate": 8,
"y_coordinate": 0,
"height": 3,
"width": 4
}
}
],
"layout_generation": "manual",
"tags": [
{
"key": "team",
"value": "backend"
},
{
"key": "environment",
"value": "production"
}
]
}
'{
"name": "My Board",
"type": "flexible",
"description": "A board created via the API",
"links": {
"board_url": "https://ui.honeycomb.io/myteam/environments/myenvironment/board/2NeeaE9bBLd"
},
"id": "2NeeaE9bBLd",
"panels": [
{
"type": "query",
"query_panel": {
"query_id": "abc1234e",
"query_annotation_id": "e4c24a35",
"query_style": "graph",
"dataset": "My Dataset",
"visualization_settings": {
"hide_compare": false,
"hide_hovers": false,
"hide_markers": false,
"utc_xaxis": false,
"overlaid_charts": false,
"charts": [
{
"chart_index": 0,
"chart_type": "default",
"hide_other": false,
"log_scale": false,
"omit_missing_values": false,
"thresholds": [
{
"value": 100,
"color": "red",
"operation": "gt",
"line_style": "filled-solid",
"label": "Critical"
}
]
}
]
}
},
"position": {
"x_coordinate": 1,
"y_coordinate": 1,
"height": 1,
"width": 1
}
}
],
"tags": [
{
"key": "team",
"value": "blue"
}
],
"preset_filters": [
{
"column": "app.Service",
"alias": "Service"
}
]
}{
"status": 400,
"type": "https://api.honeycomb.io/problems/unparseable",
"title": "The request body could not be parsed.",
"error": "invalid gzip data"
}{
"error": "unknown API key - check your credentials"
}{
"error": "Your team has been denied access to Management APIs, please contact support to be unblocked."
}{
"status": 422,
"type": "https://api.honeycomb.io/problems/validation-failed",
"error": "The provided input is invalid.",
"title": "The provided input is invalid",
"type_detail": [
{
"field": "type",
"code": "invalid",
"description": "type: must be a valid value"
}
]
}{
"error": "Rate Limited"
}{
"error": "<string>"
}Create a Board
Create a Board comprised of one or more Panels (Query, SLO, or Text). Note: Each board is limited to a maximum of 5 preset filters.
curl --request POST \
--url https://api.honeycomb.io/1/boards \
--header 'Content-Type: application/json' \
--header 'X-Honeycomb-Team: <api-key>' \
--data '
{
"name": "My API Board",
"description": "A board created via the API with mixed panel types",
"type": "flexible",
"panels": [
{
"type": "query",
"query_panel": {
"query_id": "abc1234e",
"query_annotation_id": "e4c24a35"
},
"position": {
"x_coordinate": 0,
"y_coordinate": 0,
"height": 6,
"width": 8
}
},
{
"type": "text",
"text_panel": {
"content": "# Welcome to our API Dashboard\n\nThis board shows key metrics for our services."
},
"position": {
"x_coordinate": 8,
"y_coordinate": 0,
"height": 3,
"width": 4
}
}
],
"layout_generation": "manual",
"tags": [
{
"key": "team",
"value": "backend"
},
{
"key": "environment",
"value": "production"
}
]
}
'{
"name": "My Board",
"type": "flexible",
"description": "A board created via the API",
"links": {
"board_url": "https://ui.honeycomb.io/myteam/environments/myenvironment/board/2NeeaE9bBLd"
},
"id": "2NeeaE9bBLd",
"panels": [
{
"type": "query",
"query_panel": {
"query_id": "abc1234e",
"query_annotation_id": "e4c24a35",
"query_style": "graph",
"dataset": "My Dataset",
"visualization_settings": {
"hide_compare": false,
"hide_hovers": false,
"hide_markers": false,
"utc_xaxis": false,
"overlaid_charts": false,
"charts": [
{
"chart_index": 0,
"chart_type": "default",
"hide_other": false,
"log_scale": false,
"omit_missing_values": false,
"thresholds": [
{
"value": 100,
"color": "red",
"operation": "gt",
"line_style": "filled-solid",
"label": "Critical"
}
]
}
]
}
},
"position": {
"x_coordinate": 1,
"y_coordinate": 1,
"height": 1,
"width": 1
}
}
],
"tags": [
{
"key": "team",
"value": "blue"
}
],
"preset_filters": [
{
"column": "app.Service",
"alias": "Service"
}
]
}{
"status": 400,
"type": "https://api.honeycomb.io/problems/unparseable",
"title": "The request body could not be parsed.",
"error": "invalid gzip data"
}{
"error": "unknown API key - check your credentials"
}{
"error": "Your team has been denied access to Management APIs, please contact support to be unblocked."
}{
"status": 422,
"type": "https://api.honeycomb.io/problems/validation-failed",
"error": "The provided input is invalid.",
"title": "The provided input is invalid",
"type_detail": [
{
"field": "type",
"code": "invalid",
"description": "type: must be a valid value"
}
]
}{
"error": "Rate Limited"
}{
"error": "<string>"
}Authorizations
Authenticate using a Honeycomb Configuration Key.
Pass the Token in the X-Honeycomb-Team header:
X-Honeycomb-Team: 1234567890123456789012
If you created your key using the API, use data.attributes.secret; this is the same value as the Token in the UI.
To learn how to create a Configuration Key, visit Manage Environment API Keys. To learn more about authenticating requests, visit API Authentication.
Body
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.
5Show child attributes
Show child attributes
[
{
"column": "app.Service",
"alias": "Service"
}
]
Response
Created
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.
5Show child attributes
Show child attributes
[
{
"column": "app.Service",
"alias": "Service"
}
]