---
title: AnalyticsAnnotationUpdatePayload - GraphQL Admin
description: Return type for `analyticsAnnotationUpdate` mutation.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/AnalyticsAnnotationUpdatePayload
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/AnalyticsAnnotationUpdatePayload.md
api_name: admin
api_type: graphql
type: payload
---

# Analytics​Annotation​Update​Payload

payload

Return type for `analyticsAnnotationUpdate` mutation.

## Fields

* analytics​Annotation

  [Analytics​Annotation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotation)

  The updated analytics annotation.

* user​Errors

  [\[Analytics​Annotation​Update​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotationUpdateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [analytics​Annotation​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationUpdate)

  mutation

  Updates an existing [analytics annotation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotation). Only the fields provided in the `input` argument are modified; omitted fields remain unchanged. Setting `endedAt` to `null` makes the annotation open-ended.

  An app can update only annotations that it created. If an app attempts to update an annotation that it didn't create, then the mutation returns a `NOT_FOUND` error.

  Use [`analyticsAnnotationCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationCreate) to create a new annotation, or [`analyticsAnnotationDelete`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationDelete) to remove it.

  If provided, the `type` field must specify a supported type for app-created annotations. Refer to the list of [supported types](https://shopify.dev/docs/api/shopifyql/latest/syntax/annotate#annotation-categories-and-types).

  * id

    [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

    required

    ### Arguments

    The ID of the analytics annotation to update.

  * input

    [Analytics​Annotation​Update​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/AnalyticsAnnotationUpdateInput)

    required

    The input fields for updating the analytics annotation.

  ***

***

## Map

### Mutations with this payload

* [analytics​Annotation​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationUpdate)