> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noclick.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Honeycomb

> Connect Honeycomb to your workflows: 88 operations across 11 categories.

The Honeycomb node adds Honeycomb operations to your workflows. Add it on the canvas or ask the AI builder for it by name, then pick an operation and fill in its fields.

Honeycomb also includes 2 trigger operations (marked in the tables below) that can start a workflow when something happens in Honeycomb.

<Note>
  You can wire the Honeycomb node into an AI agent as a tool provider: the agent calls the operations you allow. See [Agent tools](/agents/tools).
</Note>

## Credentials

Connect Honeycomb under **Credentials** in the node settings. See [Connecting credentials](/credentials/connecting) for the general flow.

### API key

Enter the values manually when creating the credential.

[Get your credentials here](https://docs.honeycomb.io/configure/environments/manage-api-keys).

### Management key

Enter the values manually when creating the credential.

[Get your credentials here](https://docs.honeycomb.io/configure/teams/manage-api-keys).

## Operations

### Advanced

| Operation              | ID             | Description                                          | Trigger |
| ---------------------- | -------------- | ---------------------------------------------------- | ------- |
| **REST Request (Raw)** | `rest_request` | Make an arbitrary Honeycomb REST request (v1 or v2). |         |

### Boards

| Operation             | ID                  | Description                                          | Trigger |
| --------------------- | ------------------- | ---------------------------------------------------- | ------- |
| **Create Board**      | `create_board`      | Create a new Board.                                  |         |
| **Create Board View** | `create_board_view` | Create a saved filter view on a board.               |         |
| **Delete Board**      | `delete_board`      | Delete a Board by id.                                |         |
| **Delete Board View** | `delete_board_view` | Delete a board view.                                 |         |
| **Get Board**         | `get_board`         | Get a single Board by id.                            |         |
| **Get Board View**    | `get_board_view`    | Get a single board view by id.                       |         |
| **List Board Views**  | `list_board_views`  | List all saved views for a board (max 50 per board). |         |
| **List Boards**       | `list_boards`       | List all non-secret Boards in the environment.       |         |
| **Update Board**      | `update_board`      | Update an existing Board by id (full replacement).   |         |
| **Update Board View** | `update_board_view` | Update a board view's name and filters.              |         |

### Datasets & columns

| Operation                      | ID                           | Description                                                                | Trigger |
| ------------------------------ | ---------------------------- | -------------------------------------------------------------------------- | ------- |
| **Create Column**              | `create_column`              | Create a new column in a dataset.                                          |         |
| **Create Dataset**             | `create_dataset`             | Create a new dataset.                                                      |         |
| **Create Derived Column**      | `create_derived_column`      | Create a derived column in a dataset (or **all** for environment-wide).    |         |
| **Delete Column**              | `delete_column`              | Delete a column by id.                                                     |         |
| **Delete Dataset**             | `delete_dataset`             | Delete a dataset by slug (must not be delete-protected).                   |         |
| **Delete Derived Column**      | `delete_derived_column`      | Delete a derived column by id.                                             |         |
| **Get Column**                 | `get_column`                 | Get a single column by key name (query) or by column id (path).            |         |
| **Get Dataset**                | `get_dataset`                | Get a single dataset by slug.                                              |         |
| **Get Dataset Definitions**    | `get_dataset_definitions`    | Get the definition mappings (trace id, span name, etc.) for a dataset.     |         |
| **Get Derived Column**         | `get_derived_column`         | Get a single derived column by id.                                         |         |
| **List Columns**               | `list_columns`               | List all columns in a dataset (or across all datasets with **all**).       |         |
| **List Datasets**              | `list_datasets`              | List all datasets in the environment.                                      |         |
| **List Derived Columns**       | `list_derived_columns`       | List all derived columns in a dataset (or **all** for environment-wide).   |         |
| **Update Column**              | `update_column`              | Update an existing column by id.                                           |         |
| **Update Dataset**             | `update_dataset`             | Update a dataset's settings. Complex settings go in the JSON body.         |         |
| **Update Dataset Definitions** | `update_dataset_definitions` | Update dataset definition mappings. Body maps definition types to \{name}. |         |
| **Update Derived Column**      | `update_derived_column`      | Update an existing derived column by id.                                   |         |

### Events

| Operation               | ID                    | Description                                                           | Trigger |
| ----------------------- | --------------------- | --------------------------------------------------------------------- | ------- |
| **Send Batch Events**   | `send_batch_events`   | Send a batch of events to a dataset (a JSON array of event wrappers). |         |
| **Send Event**          | `send_event`          | Send a single event to a dataset (arbitrary fields as a JSON object). |         |
| **Send Kinesis Events** | `send_kinesis_events` | Send events via an AWS Kinesis Firehose payload to a dataset.         |         |

### Management (v2)

| Operation              | ID                   | Description                                                                                 | Trigger |
| ---------------------- | -------------------- | ------------------------------------------------------------------------------------------- | ------- |
| **Create API Key**     | `create_api_key`     | Create an API key (v2 JSON:API: data.type=api-keys, attributes + environment relationship). |         |
| **Create Environment** | `create_environment` | Create an environment (v2 JSON:API envelope: data.type=environments).                       |         |
| **Delete API Key**     | `delete_api_key`     | Delete an API key by id (v2 Management API).                                                |         |
| **Delete Environment** | `delete_environment` | Delete an environment by id (v2 Management API).                                            |         |
| **Get API Key**        | `get_api_key`        | Get a single API key by id (v2 Management API).                                             |         |
| **Get Auth (v1)**      | `get_auth`           | Return metadata about the v1 API key in use (X-Honeycomb-Team).                             |         |
| **Get Auth (v2)**      | `get_auth_v2`        | Return metadata about the v2 Management key in use (Bearer key\_id:secret).                 |         |
| **Get Environment**    | `get_environment`    | Get a single environment by id (v2 Management API).                                         |         |
| **List API Keys**      | `list_api_keys`      | List API keys for the team (v2 Management API).                                             |         |
| **List Environments**  | `list_environments`  | List environments for the team (v2 Management API).                                         |         |
| **Update API Key**     | `update_api_key`     | Update an API key by id (v2 JSON:API envelope; PATCH; e.g. disable/rename).                 |         |
| **Update Environment** | `update_environment` | Update an environment by id (v2 JSON:API envelope; PATCH).                                  |         |

### Markers

| Operation                 | ID                      | Description                                                            | Trigger |
| ------------------------- | ----------------------- | ---------------------------------------------------------------------- | ------- |
| **Create Marker**         | `create_marker`         | Create a marker on a dataset (or **all** for the environment).         |         |
| **Create Marker Setting** | `create_marker_setting` | Create a marker setting (color for a marker type) on a dataset.        |         |
| **Delete Marker**         | `delete_marker`         | Delete a marker by id.                                                 |         |
| **Delete Marker Setting** | `delete_marker_setting` | Delete a marker setting by id.                                         |         |
| **List Marker Settings**  | `list_marker_settings`  | List all marker settings on a dataset.                                 |         |
| **List Markers**          | `list_markers`          | List all markers on a dataset (or **all** for the environment).        |         |
| **Update Marker**         | `update_marker`         | Update an existing marker by id.                                       |         |
| **Update Marker Setting** | `update_marker_setting` | Update a marker setting by id (type cannot be changed after creation). |         |

### Queries

| Operation                         | ID                              | Description                                                                          | Trigger |
| --------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------ | ------- |
| **Create Map Dependency Request** | `create_map_dependency_request` | Create a service-map dependency request (async computation of service dependencies). |         |
| **Create Query**                  | `create_query`                  | Create a query specification in a dataset (returns a reusable query id).             |         |
| **Create Query Annotation**       | `create_query_annotation`       | Create a query annotation (name/description for a saved query).                      |         |
| **Create Query Result**           | `create_query_result`           | Kick off asynchronous execution of a query and get a query result id.                |         |
| **Delete Query Annotation**       | `delete_query_annotation`       | Delete a query annotation.                                                           |         |
| **Get Map Dependencies**          | `get_map_dependencies`          | Get results of a service-map dependency request (paginated dependencies).            |         |
| **Get Query**                     | `get_query`                     | Retrieve a query specification by id.                                                |         |
| **Get Query Annotation**          | `get_query_annotation`          | Retrieve a single query annotation by id.                                            |         |
| **Get Query Result**              | `get_query_result`              | Poll for the result of a previously created query result.                            |         |
| **List Query Annotations**        | `list_query_annotations`        | List all query annotations in a dataset.                                             |         |
| **Update Query Annotation**       | `update_query_annotation`       | Update a query annotation's name/description.                                        |         |

### Recipients

| Operation                      | ID                                       | Description                                      | Trigger |
| ------------------------------ | ---------------------------------------- | ------------------------------------------------ | ------- |
| **Create Recipient**           | `create_recipient`                       | Create a recipient (notification target).        |         |
| **Delete Recipient**           | `delete_recipient`                       | Delete a recipient by ID.                        |         |
| **Get Recipient**              | `get_recipient`                          | Get a single recipient by ID.                    |         |
| **Get Triggers For Recipient** | `get_triggers_associated_with_recipient` | List all triggers that notify a given recipient. |         |
| **List Recipients**            | `list_recipients`                        | List all recipients for the team/environment.    |         |
| **Update Recipient**           | `update_recipient`                       | Update a recipient (full object replace).        |         |

### SLOs & burn alerts

| Operation                         | ID                              | Description                                                                       | Trigger |
| --------------------------------- | ------------------------------- | --------------------------------------------------------------------------------- | ------- |
| **Create Burn Alert**             | `create_burn_alert`             | Create a burn alert for an SLO.                                                   |         |
| **Create SLO**                    | `create_slo`                    | Create an SLO in a dataset.                                                       |         |
| **Delete Burn Alert**             | `delete_burn_alert`             | Delete a burn alert from a dataset.                                               |         |
| **Delete SLO**                    | `delete_slo`                    | Delete an SLO from a dataset.                                                     |         |
| **Get Burn Alert**                | `get_burn_alert`                | Get a single burn alert.                                                          |         |
| **Get SLO**                       | `get_slo`                       | Get a single SLO, optionally with budget/compliance detail.                       |         |
| **Get SLO History**               | `get_slo_history`               | Get a weekly breakdown of historical data for a list of SLOs (up to 24 ids).      |         |
| **Get SLO Hourly Counts History** | `get_slo_hourly_counts_history` | Get hourly-bucketed total and error event counts for an SLO over a time range.    |         |
| **Get SLO Realtime Counts**       | `get_slo_realtime_counts`       | Get per-minute success/failure event counts for an SLO from a rolling 24h window. |         |
| **List Burn Alerts**              | `list_burn_alerts`              | List burn alerts for a specific SLO in a dataset.                                 |         |
| **List SLOs**                     | `list_slos`                     | List all SLOs in a dataset.                                                       |         |
| **Update Burn Alert**             | `update_burn_alert`             | Update a burn alert (full replace, send all fields).                              |         |
| **Update SLO**                    | `update_slo`                    | Update an SLO (full replace, send all fields).                                    |         |

### Triggers

| Operation            | ID                 | Description                                                            | Trigger |
| -------------------- | ------------------ | ---------------------------------------------------------------------- | ------- |
| **On Burn Alert**    | `on_burn_alert`    | Fires when a Honeycomb SLO Burn Alert notifies this webhook recipient. | Yes     |
| **On Trigger Fired** | `on_trigger_fired` | Fires when a Honeycomb Trigger notifies this webhook recipient.        | Yes     |

### Triggers (Alerts)

| Operation          | ID               | Description                                                  | Trigger |
| ------------------ | ---------------- | ------------------------------------------------------------ | ------- |
| **Create Trigger** | `create_trigger` | Create a trigger (alert) in a dataset.                       |         |
| **Delete Trigger** | `delete_trigger` | Delete a trigger by ID.                                      |         |
| **Get Trigger**    | `get_trigger`    | Get a single trigger by ID.                                  |         |
| **List Triggers**  | `list_triggers`  | List all triggers in a dataset.                              |         |
| **Update Trigger** | `update_trigger` | Update a trigger by ID (full replacement of trigger fields). |         |
