> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenfactory.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# list_images

List available container images.

## TL;DR

* **Use when**: Finding images, checking before import
* **Returns**: List of images with UUID, tag, creation time
* **Cost**: No VM needed

## Parameters

| Parameter    | Type    | Required | Default | Description                      |
| ------------ | ------- | -------- | ------- | -------------------------------- |
| `limit`      | integer | No       | `100`   | Max images to return (1-1000)    |
| `offset`     | integer | No       | `0`     | Skip first N images              |
| `tagged`     | boolean | No       | `null`  | Only tagged images               |
| `tag_prefix` | string  | No       | `null`  | Filter by tag prefix             |
| `since`      | string  | No       | `null`  | Created after (e.g., “1h”, “1d”) |
| `until`      | string  | No       | `null`  | Created before                   |

## Response

```json theme={null}
{
  "images": [
    {
      "uuid": "abc123-def456-...",
      "tag": "python:3.11",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "uuid": "xyz789-...",
      "tag": null,
      "created_at": "2024-01-15T09:00:00Z"
    }
  ]
}
```

## Examples

### List All

```json theme={null}
{"tool": "list_images", "args": {}}
```

### Filter by Tag Prefix

```json theme={null}
{"tool": "list_images", "args": {"tag_prefix": "python"}}
```

### Only Tagged Images

```json theme={null}
{"tool": "list_images", "args": {"tagged": true}}
```

### Recent Images

```json theme={null}
{"tool": "list_images", "args": {"since": "1h"}}
```

### Pagination

```json theme={null}
{"tool": "list_images", "args": {"limit": 10, "offset": 20}}
```

## See Also

* [import\_image](./import_image) - Import new images
* [get\_image](./get_image) - Get single image details