{"uid":"cap_aEoJ_1AV7OGqAIrnZdOFa","slug":"forest-containers-oci-pull-preflight-d95eb2d3","name":"Forest Containers OCI Pull Preflight","description":"Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/container/pull-preflight?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"image":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*(?:/[A-Za-z0-9._-]+)+$","maxLength":512,"minLength":3,"description":"Public registry image repository to inspect."},"platform":{"type":"object","required":["os","arch"],"properties":{"os":{"type":"string","maxLength":32,"minLength":1,"description":"Public os value used to scope this lookup."},"arch":{"type":"string","maxLength":32,"minLength":1,"description":"Public arch value used to scope this lookup."},"variant":{"type":["string","null"],"maxLength":32,"description":"Public product options used to select an offer."}},"description":"Public platform value used to scope this lookup.","additionalProperties":false},"reference":{"type":"string","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$","maxLength":128,"minLength":1,"description":"Image tag or immutable reference to inspect."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ztdRiE9vXvDRAHrbG7d79","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"Before we pull it, preflight the image docker.io/library/nginx:latest for linux on amd64 and tell me the manifest digest, declared layer sizes, and whether any OCI referrers are attached.","exampleUseCases":[{"title":"Pre-deploy image size check","prompt":"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."},{"title":"Multi-arch manifest resolution","prompt":"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?"},{"title":"CI pipeline image validation","prompt":"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."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T00:39:42.209Z","isFirstParty":false,"canonicalSlug":"forest-containers-oci-pull-preflight-d95eb2d3"}