# Update image metadata

Update the metadata of an existing image using its unique ID. Only the metadata (name, status, labels, starred) can be updated through this endpoint, not the image file itself. To obtain a valid id, first call GET /v1/REST/images to list your images.

Endpoint: PUT /v1/REST/images/{id}
Version: 1.0.0
Security: basicAuth, bearerAuth

## Path parameters:

  - `id` (string, required)
    The ID of the image (UUID).
    Example: "550e8400-e29b-41d4-a716-446655440000"

## Request fields (application/json):

  - `Name` (string)
    The name of the image.

  - `Status` (string)
    Whether the image is open for editing or locked.
    Enum: "open", "locked"

  - `LabelIDs` (array)
    An array of IDs representing labels associated with the image.

  - `IsStarred` (boolean)
    Indicates whether the image is marked as a favorite.

## Response 200 fields (application/json):

  - `Count` (integer)
    Number of items in this response

  - `Data` (array)

  - `Data.ID` (string)
    The ID of the image (UUID).

  - `Data.Name` (string)
    The name of the image.

  - `Data.Status` (string)
    Indicates whether the image is open or locked. Values: open, locked.

  - `Data.TargetContent` (string)
    Indicates the purpose of the image. Values: image, background, video, social.

  - `Data.ImageSize` (integer)
    The size of the image file in bytes.

  - `Data.LabelIDs` (array)
    An array of IDs representing labels associated with the image.

  - `Data.IsStarred` (boolean)
    Indicates whether the image is marked as a favorite.

  - `Data.ImageUrl` (string)
    The URL where the image is stored.

  - `Data.ThumbnailUrl` (string)
    The URL where the thumbnail is stored.

  - `Data.CreatedAt` (string)
    The date and time when the image was created (RFC3339).

  - `Data.UpdatedAt` (string)
    The date and time when the image was last updated (RFC3339).

  - `Data.ExpiresAt` (string)
    The date and time when the image will expire (RFC3339).

  - `Total` (integer)
    Total number of items available


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields