> ## 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