Docker icon

Docker

Manage Docker containers, images, networks, volumes, and daemon metadata with Unix socket, TCP, TLS, or SSH connections

Actions42

Image → History

AI-generated

Summary

Fetches image history layers for a Docker image

Inputs

  • imageReference (required) — Image name, tag, digest, or ID to query history for
  • imageHistoryReturnAll — Whether to return all history layers or only up to the limit specified by imageHistoryLimit
  • imageHistoryLimit — Maximum number of history layers to return when imageHistoryReturnAll is false
  • imagePlatform — Optional JSON‑encoded OCI platform string (e.g., {"os":"linux","architecture":"amd64"}) to filter history by platform

Output shape

an array of history layer objects

Each layer includes created, id, size, and other metadata; may be truncated by the limit parameter

Examples

Example 1: Retrieve the last 10 layers of an alpine:3.20 image

imageReference: "alpine:3.20" imageHistoryReturnAll: false imageHistoryLimit: 10

Example 2: Get full history of a specific image platform

imageReference: "ubuntu:22.04" imagePlatform: "{"os":"linux","architecture":"amd64"}" imageHistoryReturnAll: true

Links

Discussion