---
title: "List files in image"
method: GET
path: "/inspect/{image_uuid}/list"
tags: ["inspect"]
---

# List files in image

`GET /inspect/{image_uuid}/list`

Returns files list

## Path parameters

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

## Query parameters

- `path` string, required
- `text` boolean

## Response `200`

OK

- DirectoryList
  - `path` string, required — The directory path that was listed
  - `files` FileItem[], required — List of files and directories in the specified path
    - `size` integer, required — File size in bytes
    - `path` string, required — File name (relative to the directory being listed)
    - `owner` union, required — File owner name or UID
      - string
      - integer
    - `group` union, required — File group name or GID
      - string
      - integer
    - `uid` integer, required — User ID of the file owner
    - `gid` integer, required — Group ID of the file
    - `mode` integer, required — File mode/permissions as integer (octal representation)
    - `mtime` integer, required — Last modification time as Unix timestamp
    - `nlink` integer, required — Number of hard links
    - `is_dir` boolean, required — True if the item is a directory
    - `is_regular` boolean, required — True if the item is a regular file
    - `is_symlink` boolean, required — True if the item is a symbolic link
    - `is_socket` boolean, required — True if the item is a socket
    - `is_fifo` boolean, required — True if the item is a FIFO/named pipe
    - `symlink_to` string, required — Target path if the item is a symbolic link, empty string otherwise

## 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 file does not exist in the image or image does not exist
- `422` — Unprocessable Entity - The specified path could not be listed inside the image

---

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