KEkernel

List images

Changed on
get/images

Request

  • Base URL
    http://localhost:4973
  • URL
    http://localhost:4973/images
  • Auth
    HTTP bearer

Query parameters

tagsTags

User-defined key-value tags.

Filter images by tag key-value pairs.

{
  "team": "backend",
  "env": "staging"
}

Response

List of images

namestring required

Normalized OCI image reference (tag or digest)

digeststring required

Resolved manifest digest

platformstring

Resolved image platform as os/arch[/variant] (e.g. "linux/amd64")

status'pending' | 'pulling' | 'converting' | 'ready' | 'failed' required

Build status

queue_positioninteger nullable

Position in build queue (null if not queued)

errorstring nullable

Error message if status is failed

size_bytesinteger nullable

Disk size in bytes (null until ready)

entrypointstring[] nullable

Entrypoint from container metadata

cmdstring[] nullable

CMD from container metadata

envobject

Environment variables from container metadata

tagsTags

User-defined key-value tags.

working_dirstring nullable

Working directory from container metadata

created_atstring date-time required

Creation timestamp (RFC3339)

Example response

[
  {
    "name": "docker.io/library/nginx:latest",
    "digest": "sha256:abc123def456...",
    "platform": "linux/amd64",
    "status": "ready",
    "queue_position": 2,
    "error": "pull failed: connection timeout",
    "size_bytes": 536870912,
    "entrypoint": [
      "/docker-entrypoint.sh"
    ],
    "cmd": [
      "nginx",
      "-g",
      "daemon off;"
    ],
    "env": {
      "PATH": "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
    },
    "tags": {
      "team": "backend",
      "env": "staging"
    },
    "working_dir": "/app",
    "created_at": "2025-01-15T10:00:00Z"
  }
]

Changes

  • 796cd163e0f1Revision changes
    • info

      added the optional property / to the response with the status

  • d3b8f05f7a0fRevision changes
    • warning

      deleted the query request parameter metadata

    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional query request parameter tags

    • info

      added the optional property / to the response with the status