---
title: "Update a library image"
method: PUT
path: "/v1/image-library/{guid}"
tags: ["Image Library"]
---

# Update a library image

`PUT /v1/image-library/{guid}`

Update an existing image library entry. If the request body is non-empty the binary data is replaced and the stored MIME type is taken from the Content-Type header. The "name" and "category" query parameters, if present, update the corresponding metadata fields; when absent the existing values are retained. Protected images cannot be modified. Requires the MANAGE_IMAGE_LIB system access right.

## Path parameters

- `guid` string, uuid, required — Image GUID.

## Query parameters

- `name` string — New image display name.
- `category` string — New image category.

## Response `200`

Image updated.

- LibraryImage
  - `guid` string, uuid — Unique image identifier.
  - `name` string — Image display name.
  - `category` string — Image category.
  - `mimeType` string — Image MIME type (e.g. image/png, image/svg+xml).
  - `isProtected` boolean — Whether the image is a system-protected image that cannot be modified or deleted.

## Other responses

- `400` — Invalid GUID.
- `401` — Unauthorized.
- `403` — Insufficient access rights or image is protected.
- `404` — Image not found.
- `500` — Database or filesystem failure.

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)