Back to Browse
Forest Containers OCI Pull Preflight
x402
Forest Containers OCI Pull Preflight is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-22).
Performs a preflight inspection of a public OCI container image for a specified target platform, returning manifest metadata, config/layer sizes, and referrer presence without downloading any layers.
Price / call$0.005
Success—
StatusUnknown
How this service works
Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.
Output
Returns resolved manifest metadata for the specified image and platform, including the selected child manifest digest (for multi-arch images), declared config size, declared individual layer sizes, and a bounded check on OCI referrer presence. No layer data is downloaded. Referrer presence is reported as a fact only and does not imply signature, SBOM, attestation, or vulnerability verification.
Example use cases
Pre-deploy image size check
“Before we deploy, preflight the image ghcr.io/myorg/myapp:v2.3.1 targeting linux/arm64 and tell me the total declared layer size so I can estimate how long the pull will take on our edge nodes.”
Multi-arch manifest resolution
“I need to know which exact child manifest will be selected when we pull quay.io/prometheus/prometheus:v2.51.0 on a linux amd64 host — can you preflight it and give me the immutable digest?”
CI pipeline image validation
“In our CI pipeline, preflight docker.io/library/python:3.12-slim for linux arm/v7 variant and confirm the tag resolves cleanly and report the config and layer sizes before we let the build proceed.”
Technical details
Endpoint
POSThttps://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/container/pull-preflight?utm_source=zero.xyzWhen to prefer
Use this endpoint when you need to inspect an OCI container image's manifest metadata and layer sizes for a specific target platform before committing to a pull or deploy — especially in bandwidth-sensitive or resource-constrained environments. Prefer this over a full docker pull when you only need size information, digest resolution, or platform compatibility checks. Ideal for CI/CD pipelines that need to validate image references without incurring download costs. Choose this over generic registry API calls when you want a structured, paid-API response with bounded referrer presence checking included.
Side effects
- Image not found or registry unreachable — returns error indicating the repository or tag does not exist
- Tag does not resolve for the requested platform — no matching child manifest in the index
- Invalid image reference format — input fails pattern validation
- Platform OS or arch string not recognized or not present in multi-arch manifest
- Registry rate limiting or authentication required for a non-public image — endpoint only supports anonymously readable images
- Referrer API not supported by the registry — referrer check may return empty or unsupported
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| image | string | Public registry image repository to inspect. |
| platform | object | Public platform value used to scope this lookup. |
| reference | string | Image tag or immutable reference to inspect. |
Output
Schema · Response
{
"type": "json",
"example": {
"ok": true,
"data": {
"size": {
"layer_bytes": 0,
"layer_count": 0,
"config_bytes": 0,
"total_declared_bytes": 0
},
"image": "example",
"state": "ready",
"source": "OCI Distribution API",
"reference": "example",
"referrers": {
"count": 0,
"items": [],
"truncated": false,
"api_supported": false,
"artifact_types": [],
"returned_count": 0
},
"index_digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
"verification": {
"sbom_validated": false,
"signature_verified": false,
"vulnerability_scan_performed": false
},
"platform_supported": false,
"requested_platform": {
"os": "example",
"arch": "example"
},
"selected_manifest_digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
"selected_manifest_media_type": "example"
},
"meta": {
"cache": "miss",
"provider": "oci-distribution",
"checked_at": "2026-01-01T00:00:00.000Z",
"duration_ms": 0
},
"version": "1",
"capability": "container.pull-preflight"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"