Container Changed
Watch an OCI tag for digest and platform changes with a deterministic hash. Registry timestamps and unrelated annotations are ignored; no layers are pulled.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
$0.001 / callPOST /container/changedx402 · Base
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- has this container image changed
- should I refresh the saved image state
- what changed in the image tag
What Forest guarantees
- bounded normalized public-source lookup
Boundaries
- provider-specific guarantees
- unpublished facts
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
{
"image": "registry.k8s.io/pause",
"tag": "3.10",
"previous_hash": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
}
Canonical paid endpoint
https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/container/changed
Related capabilities
- Container Digest — Resolve a mutable OCI tag to an immutable content digest using bounded Distribution manifest metadata. It does not assert signature or vulnerability status.
- Container Platforms — Return deterministic OS/architecture variants from an OCI image index or manifest list. It reads bounded manifest metadata only and never downloads image layers.
- Container Referrers — Discover OCI 1.1 artifacts referring to an image digest, such as SBOM or attestation evidence. Presence is reported only; Forest does not verify signatures or download blobs.
- Container Size — Return registry-declared config and layer bytes for one OCI image manifest before an agent pulls it. Multi-architecture indexes require a platform-specific child digest and are rejected because their total image size is not determinate without a platform. Values are declarations, not a compressed download or vulnerability measurement.
- Container Tag-state — Check an anonymously readable OCI image tag and resolve its manifest digest through the standard Distribution API. No blob pull, push, delete or private registry access is performed.
- Container Pull-preflight — Preflight one anonymously readable OCI image for a requested target platform before pull or deploy. Forest resolves the supplied tag once, selects one exact multi-arch child manifest when possible, reports that immutable manifest declared config/layer size, and checks bounded OCI referrer presence. No layers are downloaded and referrer presence is never treated as signature, SBOM, attestation or vulnerability verification.