---
title: "Create a library image"
method: POST
path: "/v1/image-library"
tags: ["Image Library"]
---

# Create a library image

`POST /v1/image-library`

Create a new image library entry. The request body must be the raw image bytes and the Content-Type header becomes the stored MIME type. The image name is passed as the "name" query parameter and is required. Requires the MANAGE_IMAGE_LIB system access right.

## Query parameters

- `name` string, required — Image display name.
- `category` string — Image category (defaults to "Default").

## Response `201`

Image created.

- 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` — Missing name, empty body, or invalid parameters.
- `401` — Unauthorized.
- `403` — Insufficient access rights.
- `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)