Skip to main content
PUT
/
1
/
boards
/
{boardId}
/
views
/
{viewId}
Update a Board View
curl --request PUT \
  --url https://api.honeycomb.io/1/boards/{boardId}/views/{viewId} \
  --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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Honeycomb-Team
string
header
required

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.

Path Parameters

​
boardId
string
required

The unique identifier (ID) of a Board.

​
viewId
string
required

The unique identifier (ID) of a Board View.

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
​
id
string

Unique identifier for the board view.

Example:

"eC_abc123"

Response

Success

​
id
string

Unique identifier for the board view.

Example:

"eC_abc123"

​
name
string

The name of the view.

Example:

"My View"

​
filters
object[]