---
title: AnalyticsAnnotationUpdateUserError - GraphQL Admin
description: An error that occurs during the execution of `AnalyticsAnnotationUpdate`.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotationUpdateUserError
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotationUpdateUserError.md
api_name: admin
api_type: graphql
type: object
---

# Analytics​Annotation​Update​User​Error

object

An error that occurs during the execution of `AnalyticsAnnotationUpdate`.

## Fields

* code

  [Analytics​Annotation​Update​User​Error​Code](https://shopify.dev/docs/api/admin-graphql/latest/enums/AnalyticsAnnotationUpdateUserErrorCode)

  The error code.

* field

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

  The path to the input field that caused the error.

* message

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

  non-null

  The error message.

***

## Map

No referencing types

***

## Mutations

* [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.

  ***

***

## AnalyticsAnnotationUpdateUserError Mutations

### Mutated by

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

***

## Interfaces

* [Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError)

  interface

***

## AnalyticsAnnotationUpdateUserError Implements

### Implements

* [Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError)