API version: unstable
API version: 2021-07 Release candidate
API version: 2021-04 Latest
API version: 2021-01
API version: 2020-10
API version: 2020-07
API version: 2020-04
API version: 2020-01 Unsupported
API version: 2019-10 Unsupported

productImageUpdate mutation

Version unstable

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2021-07 (Release candidate)

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2021-04 (Latest)

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2021-01

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2020-10

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2020-07

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2020-04 (Unsupported)

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2020-01 (Unsupported)

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2019-10 (Unsupported)

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2019-07 (Unsupported)

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2019-04 (Unsupported)

Updates an image of a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
image ( ImageInput! ) required

Image to be updated.
productId ( ID! ) required

The ID of the product on which to update the image.

ImageInput fields

  • altText (String)

    A word or phrase to share the nature or contents of an image.

  • id (ID)

    Globally unique identifier.

  • src (String)

    The URL of the image. May be a signed upload URL.

Return fields

  • image (Image)

    Image updated.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.
    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.
    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.
    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1
  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.