---
title: "Add a tag to an image"
method: PATCH
path: "/images/{imageUUID}/tag"
tags: ["images"]
---

# Add a tag to an image

`PATCH /images/{imageUUID}/tag`

Adds a tag to an image. Tags are unique per namespace; if the requested tag is already
assigned to another image, it will be moved to this image.

Assigning a tag that matches a public tag to a public image will freeze that tag
to the current image - subsequent public updates to the tag will not affect it.
To make the public tag track the latest public image again, remove your tag assignment.

When a tag is removed from an image that resides in the public namespace, the API returns HTTP 200 OK.
response body contains the tag that now points to the public image
(i.e., the image that the tag is automatically re‑assigned to).

In other words, un‑tagging a public image does not delete the tag; it simply moves the tag back to the public
image and the caller receives that tag in the successful response.

## Path parameters

- `imageUUID` string, uuid, required — A UUID string

## Request body

- object
  - `tag` string, required — New tag for the image

## Response `200`

OK

- Image
  - `uuid` string, uuid — A UUID string
  - `tag` string, nullable — Tag to identify the image
  - `created_at` string — ISO 8601 formatted timestamp of when the image was created
  - `operation_uuid` string, uuid — A UUID string

## Other responses

- `400` — Bad Request - Invalid request parameters
- `401` — Unauthorized - Invalid or missing authentication credentials. Either the `Authorization` bearer token is missing or invalid, or the `Project` header is missing.
- `403` — Forbidden - Token does not have sufficient permissions
- `404` — Not Found - The requested resource does not exist

---

[API](https://skmtc.dev/nebius/apis/nebius-openai-compatible-inference-api.md) · [All operations](https://skmtc.dev/nebius/apis/nebius-openai-compatible-inference-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nebius/nebius-openai-compatible-inference-api/revisions/0fb323abba3c/schema)