Skip to main content
GET
Error

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

image_uuid
string<uuid>
required

The UUID of the image to inspect A UUID string

Example:

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

Query Parameters

pattern
string
required

Regex pattern to search for. May be repeated (max 16); patterns are OR-ed. Max 1024 characters each.

Example:

"^PermitRootLogin"

path
string
default:/

File or directory to search inside the image. Defaults to the rootfs root.

Example:

"/etc"

glob
string

Glob to filter files (ripgrep -g semantics, "!" negates). May be repeated.

Example:

"*.conf"

max_count
integer

Maximum matches per file (hard cap 10000).

Required range: 1 <= x <= 10000
max_total
integer
default:1000

Maximum total matches across all files (default 1000, hard cap 10000).

Required range: 1 <= x <= 10000
case
enum<string>
default:sensitive

Case sensitivity mode.

Available options:
sensitive,
insensitive,
smart

Response

OK

path
string
required

The path inside the image that was searched

Example:

"/etc"

patterns
string[]
required

The patterns that were searched for

Example:
matches
object[]
required
truncated
boolean
required

True when max_total or the search deadline stopped the search early

Example:

false