Skip to main content
POST
/
1
/
boards
/
{boardId}
/
views
Create a Board View
curl --request POST \
  --url https://api.honeycomb.io/1/boards/{boardId}/views \
  --header 'Content-Type: application/json' \
  --header 'X-Honeycomb-Team: <api-key>' \
  --data '
{
  "name": "Errors View",
  "filters": [
    {
      "column": "status",
      "operation": "=",
      "value": "error"
    }
  ]
}
'
{
  "id": "eC_abc123",
  "name": "My View",
  "filters": [
    {
      "column": "status",
      "operation": "=",
      "value": "error"
    }
  ]
}

Authorizations

​
X-Honeycomb-Team
string
header
required

A Honeycomb Configuration Key is required to use this API. A Configuration Key can be found in the API Keys section of the environment configuration, which can be found under Environment Settings -> API Keys -> Configuration tab. Check out our documentation to find your API Keys.

More information can be found in Manage Environments.

Path Parameters

​
boardId
string
required

The unique identifier (ID) of a Board.

Body

application/json
​
name
string
required

The name of the view.

Required string length: 1 - 255
Example:

"My View"

​
filters
object[]
required

The filters to apply to this view.

Minimum array length: 1

Response

Created

​
id
string

Unique identifier for the board view.

Example:

"eC_abc123"

​
name
string

The name of the view.

Example:

"My View"

​
filters
object[]