Error

A valid request URL is required to generate request examples

{
  "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"
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

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

Error

A valid request URL is required to generate request examples

{
  "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"
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

IAM bearer token issued by the Nebius IAM service. Sent as Authorization: Bearer <iam-token>. Must be combined with the Project header (see IAMProjectHeader).

This is the recommended authentication scheme for new clients.

Project

string

header

required

Nebius project ID associated with the IAM token. Required together with IAMBearerAuth. Identifies the project context the request is scoped to.

Path Parameters

imageUUID

string<uuid>

required

The UUID of the image to update A UUID string

Example:

"12345678-9abc-baba-deda-0123456789ab"

Body

application/json

tag

string

required

New tag for the image

Example:

"busybox:latest"

Response

uuid

string<uuid>

A UUID string

Example:

"12345678-9abc-baba-deda-0123456789ab"

tag

string | null

Tag to identify the image

Example:

"busybox:latest"

created_at

string

ISO 8601 formatted timestamp of when the image was created

Example:

"2024-01-01T12:00:00+00:00"

operation_uuid

string<uuid> | null

UUID of the operation that created this image. Returns null when the image belongs to a different namespace (e.g. public images) or when the image was not created by an operation (e.g. shared images).

Example:

"12345678-9abc-baba-deda-0123456789ab"

Remove tags from an image Import a container image from a registry

⌘I

API Documentation

Inference and Training

Sandboxes

Add a tag to an image

Authorizations

Path Parameters

Body

Response