# Update a Query Annotation

Update a Query Annotation by specifying its ID. The Query ID associated with the Query Annotation cannot be updated. Partial updates are not supported.


Endpoint: PUT /1/query_annotations/{datasetSlug}/{queryAnnotationId}
Version: 1.0.0
Security: configuration_key

## Path parameters:

  - `datasetSlug` (string, required)
    The dataset slug or use  for endpoints that support environment-wide operations.

  - `queryAnnotationId` (string, required)
    The unique identifier (ID) of the annotation.

## Request fields (application/json):

  - `name` (string, required)
    A name for the Query.
    Example: "My Named Query"

  - `description` (string)
    A description of the Query.
    Example: "A nice description of My Named Query"

  - `query_id` (string, required)
    The ID of the Query that the annotation describes. : Once created, it is NOT possible to change the query ID associated with an annotation. It is possible to have multiple annotations associated with a Query.
    Example: "mabAMpSPDjH"

## Response 200 fields (application/json):

  - `name` (string, required)
    A name for the Query.
    Example: "My Named Query"

  - `description` (string)
    A description of the Query.
    Example: "A nice description of My Named Query"

  - `query_id` (string, required)
    The ID of the Query that the annotation describes. : Once created, it is NOT possible to change the query ID associated with an annotation. It is possible to have multiple annotations associated with a Query.
    Example: "mabAMpSPDjH"

  - `id` (string)
    The unique identifier (ID) of a Query Annotation.
    Example: "sGUnkBHgRFN"

  - `created_at` (string)
    ISO8601 formatted time when the Query Annotation was created.
    Example: "2022-10-26T21:36:04Z"

  - `updated_at` (string)
    ISO8601 formatted time when the Query Annotation was updated.
    Example: "2022-12-04T08:14:26Z"

  - `source` (string)
    The source of the Query Annotation.
    Enum: "query", "board"

## Response 400 fields (application/json):

  - `error` (string)

## Response 404 fields (application/json):

  - `error` (string)

## Response 429 fields (application/json):

  - `error` (string)

## Response default fields (application/json):

  - `error` (string)