# Query Annotations

Query Annotations in Honeycomb allow you to associate names and descriptions to queries to add additional information in collaboration features.

This API allows you to list, create, update, and delete Query Annotations.



## Create a Query Annotation

 - [POST /1/query_annotations/{datasetSlug}](https://api-docs.honeycomb.io/api/query-annotations/createqueryannotation.md): Create a Query Annotation for the specified query ID.


## List Query Annotations

 - [GET /1/query_annotations/{datasetSlug}](https://api-docs.honeycomb.io/api/query-annotations/listqueryannotations.md): List all Query Annotations in the specified dataset.


## Get a Query Annotation

 - [GET /1/query_annotations/{datasetSlug}/{queryAnnotationId}](https://api-docs.honeycomb.io/api/query-annotations/getqueryannotation.md): Get a Query Annotation by its ID.


## Update a Query Annotation

 - [PUT /1/query_annotations/{datasetSlug}/{queryAnnotationId}](https://api-docs.honeycomb.io/api/query-annotations/updatequeryannotation.md): Update a Query Annotation by specifying its ID. The Query ID associated with the Query Annotation cannot be updated. Partial updates are not supported.


## Delete a Query Annotation

 - [DELETE /1/query_annotations/{datasetSlug}/{queryAnnotationId}](https://api-docs.honeycomb.io/api/query-annotations/deletequeryannotation.md): Delete a Query Annotation by specifying its ID.