Actions42
- Container Actions
- Image Actions
- Network Actions
- System Actions
- Volume Actions
Image → Remove
AI-generatedSummary
Remove a Docker image
Inputs
- imageReference (required) — Image name, tag, digest, or ID (e.g., alpine:3.20 or sha256:abc123)
- imageRemoveForce — Whether to remove the image even if it is used by stopped containers or has other tags
- imageKeepUntaggedParents — Whether to keep untagged parent images when removing this image
Output shape
no body — operation succeeds silently or fails with an error
Returns nothing on success; throws an error if removal is not allowed
Examples
Example 1: Delete an image by its tag
imageReference: alpine:3.20
Example 2: Force removal of an image used by stopped containers
imageReference: myrepo/app:latest, imageRemoveForce: true
Example 3: Keep untagged parent images while removing a child image
imageReference: nginx:latest, imageKeepUntaggedParents: true