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

# PutPanelAnnotation



## OpenAPI

````yaml openapi/api_v1_data_openapi3_DOCUMENTATION_ONLY.json PUT /api/v1/data/panel_annotations/{id}
openapi: 3.0.3
info:
  description: |

    The Data API provides HTTP/JSON REST endpoints for reading and writing data
    to the Chronosphere system.

    Use this link to download the raw Swagger specification:
    <a href="/api/v1/data/swagger.json">/api/v1/data/swagger.json</a>
  title: Data V1 API
  version: v1
servers:
  - url: https://{tenant}.chronosphere.io
    variables:
      tenant:
        default: tenant
        description: tenant ID assigned by the service provider
security:
  - ApiKeyAuth: []
tags:
  - name: DataV1
paths:
  /api/v1/data/panel_annotations/{id}:
    put:
      tags:
        - DataV1
      operationId: PutPanelAnnotation
      parameters:
        - description: Unique identifier of the panel annotation.
          in: path
          name: id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DataV1PutPanelAnnotationBody'
        required: true
        x-originalParamName: body
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/datav1PanelAnnotationResponse'
          description: A successful response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googlerpcStatus'
          description: An unexpected error response.
components:
  schemas:
    DataV1PutPanelAnnotationBody:
      properties:
        labels:
          additionalProperties:
            type: string
          description: |-
            Map of user-supplied key:value pairs associated with the event. The
            following maximums apply:
            - Number of labels per event: `50`
            - Key character length: `200`
            - Value character length: `500`
          type: object
        starts_at:
          description: The start time of the period being annotated.
          format: date-time
          type: string
        title:
          description: >-
            A short description explaining the annotation. Maximum character
            length: `100`.
          type: string
      type: object
    datav1PanelAnnotationResponse:
      properties:
        created_by:
          description: Display name of the creator of this annotation.
          type: string
        id:
          description: Unique identifier of the panel annotation.
          type: string
        labels:
          additionalProperties:
            type: string
          description: >-
            Map of user-supplied key:value pairs associated with the annotation.
            The

            following maximums apply:

            - Number of labels per annotation: `50`

            - Key character length: `200`

            - Value character length: `500`
          type: object
        starts_at:
          description: The start of the time period being annotated.
          format: date-time
          type: string
        target_reference:
          description: The `slug` of the resource being annotated.
          type: string
        title:
          description: |-
            A short description explaining the annotation.
            Max length, 100 characters.
          type: string
        type:
          allOf:
            - $ref: '#/components/schemas/datav1PanelAnnotationTargetType'
          description: The type of resource being annotated.
      type: object
    googlerpcStatus:
      properties:
        code:
          format: int32
          type: integer
        details:
          items:
            $ref: '#/components/schemas/protobufAny'
          type: array
        message:
          type: string
      type: object
    datav1PanelAnnotationTargetType:
      enum:
        - DASHBOARD
      type: string
    protobufAny:
      additionalProperties: {}
      properties:
        '@type':
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Chronosphere API token
      in: header
      name: API-Token
      type: apiKey

````