updateOptionValue

mutation

Requires commerce.product:write.

Update an existing option value.

Required headers

Header	Required	Description
`x-store-id`	Yes	ID of the store the operation targets. Omitting it returns HTTP 200 with a GraphQL error: `extensions.code: "UNAUTHENTICATED"`.

Go to Authentication for credential setup.

Arguments

id String! required
input MutationUpdateOptionValueInput! required
- label String optional
- metafields [UpsertMetafieldInput!] optional
  - key String! required
  - namespace String! required
  - type String! required
  - value String! required
- name String optional
- position Int optional

Possible returns

OptionValue OptionValue

mutation RunUpdateOptionValue($id: String!, $input: MutationUpdateOptionValueInput!) {  updateOptionValue(id: $id, input: $input) {    id    name    label    createdAt    updatedAt    position  }}

{  "data": {    "updateOptionValue": {      "id": "ID_VALUE",      "name": "Example",      "label": "Example",      "createdAt": "2026-01-15T12:00:00.000Z",      "updatedAt": "2026-01-15T12:00:00.000Z",      "position": 1    }  }}

Last updated on