Skip to main content
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

ParameterTypeRequiredDefaultDescription
limitintegerNo100Max images to return (1-1000)
offsetintegerNo0Skip first N images
taggedbooleanNonullOnly tagged images
tag_prefixstringNonullFilter by tag prefix
sincestringNonullCreated after (e.g., “1h”, “1d”)
untilstringNonullCreated before

​
Response

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

{"tool": "list_images", "args": {}}

​
Filter by Tag Prefix

{"tool": "list_images", "args": {"tag_prefix": "python"}}

​
Only Tagged Images

{"tool": "list_images", "args": {"tagged": true}}

​
Recent Images

{"tool": "list_images", "args": {"since": "1h"}}

​
Pagination

{"tool": "list_images", "args": {"limit": 10, "offset": 20}}

​
See Also