Sign in

v1

latestOpenAPI 3.1.02026-07-2675394318.9 KB
images

Add a tag to an image

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.

patch/images/{imageUUID}/tag

Path parameters

imageUUIDstring uuid required

A UUID string

Example:12345678-9abc-baba-deda-0123456789ab

The UUID of the image to update

Request body

tagstring required

New tag for the image

Example request

{
  "tag": "busybox:latest"
}

Response

OK

uuidstring uuid

A UUID string

tagstring nullable

Tag to identify the image

created_atstring

ISO 8601 formatted timestamp of when the image was created

operation_uuidstring uuid

A UUID string

Example response

{
  "uuid": "12345678-9abc-baba-deda-0123456789ab",
  "tag": "busybox:latest",
  "created_at": "2024-01-01T12:00:00+00:00",
  "operation_uuid": "12345678-9abc-baba-deda-0123456789ab"
}