> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# UpdateGalleryItem

# Package: proGallery

# Namespace: ProGallery

# Method link: https://dev.wix.com/docs/api-reference/assets/pro-gallery/update-gallery-item.md

## Permission Scopes:
Manage Galleries: SCOPE.DC-PROGALLERY.MANAGE-GALLERIES

## Introduction

Updates a media item in a specified gallery.

> **Note:** When creating or updating image items in a pro gallery, the images must be uploaded or imported to the [Wix Media Manager](https://dev.wix.com/api/rest/media/media-manager) first, as the `imageInfo` parameter currently only supports the Wix Media URL.

---

## REST API

### Schema

```
 Method: updateGalleryItem
 Description: Updates a media item in a specified gallery.  > **Note:** When creating or updating image items in a pro gallery, the images must be uploaded or imported to the [Wix Media Manager](https://dev.wix.com/api/rest/media/media-manager) first, as the `imageInfo` parameter currently only supports the Wix Media URL.
 URL: https://www.wixapis.com/pro-gallery/v2/galleries/{galleryId}/items/{item.id}
 Method: PATCH
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  item.id, item
 Method parameters: 
   param name: item | type: Item   | required: true
    - ONE-OF: - required: true
     - name: image | type: Image | description: Details about the image. 
        - name: imageInfo | type: Image | description: Information about the Wix Media image. 
           - name: id | type: string | description: *Required.** WixMedia image GUID. 
           - name: height | type: integer | description: *Required.** Original image height. 
           - name: width | type: integer | description: *Required.** Original image width. 
           - name: altText | type: string | description: Image alt text. 
           - name: filename | type: string | description: Image filename. 
        - name: focalPoint | type: Point | description: Focal point of the image. 
           - name: x | type: number | description: X-coordinate of the focal point. 
           - name: y | type: number | description: Y-coordinate of the focal point. 
        - name: exif | type: object | description: Set of key-value pairs describing the media in [Exchangeable Image File format](https://en.wikipedia.org/wiki/Exif). 
        - name: quality | type: integer | description: Image compression level. <br />  Min: `30` <br /> Max: `100` 
        - name: unsharpMasking | type: UnsharpMasking | description: [Unsharp masking](https://en.wikipedia.org/wiki/Unsharp_masking) values of the image. 
           - name: amount | type:  | description: Unsharp masking amount. Controls the sharpening strength. <br />  Min: `0` <br /> Max: `5` 
           - name: radius | type:  | description: Unsharp masking radius in pixels. Controls the sharpening width. 
           - name: threshold | type:  | description: Unsharp masking threshold. Controls how different neighboring pixels must be for sharpening to apply. <br />  Min: `0` <br /> Max: `1` 
     - name: video | type: Video | description: Details about the video. 
        - name: type | type: VideoType | description: Type of video. 
             - enum: UNDEFINED, WIX_MEDIA, YOUTUBE, VIMEO
        - name: videoInfo | type: VideoV2 | description: Information about the video. 
           - name: id | type: string | description: WixMedia GUID. Required when associating an existing Wix Media video. 
           - name: url | type: string | description: Video URL. Required when associating a video from an external source. Supported sources: YouTube, Vimeo. 
           - name: resolutions | type: array<VideoResolution> | description: Available resolutions for the video, starting with the optimal resolution. 
              - name: url | type: string | description: *Required.** Video URL. 
              - name: height | type: integer | description: *Required.** Video height. 
              - name: width | type: integer | description: *Required.** Video width. 
              - name: format | type: string | description: *Required.** Video format. For example, `mp4` or `hls`. 
              - name: quality | type: string | description: Video quality. For example, `480p` or `720p`. 
              - name: filename | type: string | description: Video filename. 
           - name: filename | type: string | description: Video filename. 
           - name: posters | type: array<Image> | description: Video posters. 
        - name: durationInMillis | type: integer | description: Manually defined video duration in milliseconds. 
     - name: text | type: Text | description: Details about the text file. 
        - name: html | type: string | description: Text in HTML format. 
        - name: css | type: object | description: Set of key-value pairs describing the [CSS style](https://en.wikipedia.org/wiki/CSS) of the text.  __Note:__ The object structure is customizable. See the [List Gallery Items](https://dev.wix.com/api/rest/site-content/pro-gallery/list-gallery-items) code example for supported values. 
        - name: editorHtml | type: string | description: Reserved for internal use. 
        - name: editorFontId | type: string | description: Reserved for internal use. 
        - name: id | type: string | description: Item GUID. | required: true
        - name: sortOrder | type: number | description: Index that determines which position a media item is displayed in the gallery. <br />  Default: [Epoch](https://www.epoch101.com/) timestamp. <br />  >**Note:** If you assign the same sort order index to more than one media item in a gallery, the function fails. 
        - name: title | type: string | description: Item title. 
        - name: description | type: string | description: Item description. 
        - name: link | type: Link | description: Link from the item. You can link to Wix sites or external URLs. 
           - name: text | type: string | description: Display text of the link. 
           - name: url | type: string | description: Target URL of the link. 
        - name: tags | type: Tags | description: Item tags. 
           - name: values | type: array | description: List of tags assigned to the media item. 
 Return type: UpdateGalleryItemResponse
  - name: item | type: Item | description: Updated media item. 
     - ONE-OF: 
        - name: image | type: Image | description: Details about the image. 
           - name: imageInfo | type: Image | description: Information about the Wix Media image. 
              - name: id | type: string | description: *Required.** WixMedia image GUID. 
              - name: url | type: string | description: Image URL. 
              - name: height | type: integer | description: *Required.** Original image height. 
              - name: width | type: integer | description: *Required.** Original image width. 
              - name: altText | type: string | description: Image alt text. 
              - name: filename | type: string | description: Image filename. 
           - name: focalPoint | type: Point | description: Focal point of the image. 
              - name: x | type: number | description: X-coordinate of the focal point. 
              - name: y | type: number | description: Y-coordinate of the focal point. 
           - name: exif | type: object | description: Set of key-value pairs describing the media in [Exchangeable Image File format](https://en.wikipedia.org/wiki/Exif). 
           - name: quality | type: integer | description: Image compression level. <br />  Min: `30` <br /> Max: `100` 
           - name: unsharpMasking | type: UnsharpMasking | description: [Unsharp masking](https://en.wikipedia.org/wiki/Unsharp_masking) values of the image. 
              - name: amount | type:  | description: Unsharp masking amount. Controls the sharpening strength. <br />  Min: `0` <br /> Max: `5` 
              - name: radius | type:  | description: Unsharp masking radius in pixels. Controls the sharpening width. 
              - name: threshold | type:  | description: Unsharp masking threshold. Controls how different neighboring pixels must be for sharpening to apply. <br />  Min: `0` <br /> Max: `1` 
        - name: video | type: Video | description: Details about the video. 
           - name: type | type: VideoType | description: Type of video. 
                 - enum: UNDEFINED, WIX_MEDIA, YOUTUBE, VIMEO
           - name: videoInfo | type: VideoV2 | description: Information about the video. 
              - name: id | type: string | description: WixMedia GUID. Required when associating an existing Wix Media video. 
              - name: url | type: string | description: Video URL. Required when associating a video from an external source. Supported sources: YouTube, Vimeo. 
              - name: resolutions | type: array<VideoResolution> | description: Available resolutions for the video, starting with the optimal resolution. 
                 - name: url | type: string | description: *Required.** Video URL. 
                 - name: height | type: integer | description: *Required.** Video height. 
                 - name: width | type: integer | description: *Required.** Video width. 
                 - name: format | type: string | description: *Required.** Video format. For example, `mp4` or `hls`. 
                 - name: quality | type: string | description: Video quality. For example, `480p` or `720p`. 
                 - name: filename | type: string | description: Video filename. 
              - name: filename | type: string | description: Video filename. 
              - name: posters | type: array<Image> | description: Video posters. 
           - name: durationInMillis | type: integer | description: Manually defined video duration in milliseconds. 
        - name: text | type: Text | description: Details about the text file. 
           - name: html | type: string | description: Text in HTML format. 
           - name: css | type: object | description: Set of key-value pairs describing the [CSS style](https://en.wikipedia.org/wiki/CSS) of the text.  __Note:__ The object structure is customizable. See the [List Gallery Items](https://dev.wix.com/api/rest/site-content/pro-gallery/list-gallery-items) code example for supported values. 
           - name: editorHtml | type: string | description: Reserved for internal use. 
           - name: editorFontId | type: string | description: Reserved for internal use. 
     - name: id | type: string | description: Item GUID. 
     - name: sortOrder | type: number | description: Index that determines which position a media item is displayed in the gallery. <br />  Default: [Epoch](https://www.epoch101.com/) timestamp. <br />  >**Note:** If you assign the same sort order index to more than one media item in a gallery, the function fails. 
     - name: title | type: string | description: Item title. 
     - name: description | type: string | description: Item description. 
     - name: link | type: Link | description: Link from the item. You can link to Wix sites or external URLs. 
        - name: text | type: string | description: Display text of the link. 
        - name: url | type: string | description: Target URL of the link. 
     - name: type | type: Type | description: Type of item. 
         - enum: UNDEFINED, IMAGE, VIDEO, TEXT
     - name: createdDate | type: string | description: Date and time the item was created. 
     - name: updatedDate | type: string | description: Date and time the item was last updated. 
     - name: tags | type: Tags | description: Item tags. 
        - name: values | type: array | description: List of tags assigned to the media item. 


```

### Examples

### Update an item in a gallery
```curl
curl -X PATCH \
'https://www.wixapis.com/progallery/v2/galleries/2113aed5-8ebd-418a-a60b-74a799ce50e0/items/d02bd19a-c0a3-456a-9c82-32c08ceb6712' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
-d '{
  "item": {
    "title": "Newly Updated Item1",
    "description": "Describe your image here1."
  }
}'
```

---