updateSkuMediaObjects

mutation

Requires commerce.product:write.

Add media objects or update existing media objects to existing SKU.

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 MutationUpdateSkuMediaObjectsInput! required
- mediaObjects [UpdateMediaObjectInput!]! required
  - id String! 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
  - type String optional — The type of the media, one of PHOTO, VIDEO, IMAGE, AUDIO.
  - url String optional

Possible returns

SKU SKU — A SKU represents a stock keeping unit (SKU) in the catalog.

mutation RunUpdateSkuMediaObjects($id: String!, $input: MutationUpdateSkuMediaObjectsInput!) {  updateSkuMediaObjects(id: $id, input: $input) {    id    name    status    code    label    createdAt  }}

{  "data": {    "updateSkuMediaObjects": {      "id": "ID_VALUE",      "name": "Example",      "status": "ACTIVE",      "code": "EXAMPLE-001",      "label": "Example",      "createdAt": "2026-01-15T12:00:00.000Z"    }  }}

Last updated on