{"uid":"cap_JHjw0x-Wdpl3GkkaYDA8P","slug":"forest-containers-oci-image-size-inspector-0615fde0","name":"Forest Containers – OCI Image Size Inspector","description":"Return manifest-declared OCI config and layer sizes before an agent pulls an image. Values are registry declarations, not a compressed download or vulnerability measurement. Base mainnet USDC","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/container/size?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"image":{"type":"string","pattern":"^[a-z0-9][a-z0-9._-]*(?::\\d+)?(?:/[a-z0-9._-]+)+$","maxLength":512,"description":"Public registry image repository to inspect."},"reference":{"type":"string","maxLength":256,"minLength":1,"description":"Repository branch whose current state should be checked."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ziAEh_ak-ZJwCO4pOsZnx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns manifest-declared OCI config metadata and individual layer sizes for a public container image before pulling it.","exampleAgentPrompt":"Before I pull it, can you check the manifest-declared layer sizes and OCI config for the public image library/nginx with the latest tag?","exampleUseCases":[{"title":"Pre-pull image size check","prompt":"I need to know how large the ubuntu:22.04 image is before I pull it to my edge node — can you get the declared layer sizes from the manifest without actually downloading it?"},{"title":"CI pipeline size gating","prompt":"In our pipeline, check the manifest-declared total layer size for the image myorg/myapp on the main branch and tell me if any individual layer exceeds 500MB."},{"title":"Comparing image weights across tags","prompt":"Can you look up the OCI config and layer sizes for python:3.12-slim from the public registry so I can compare it against the full python:3.12 image before choosing which base to use?"}],"resultDescription":"Returns the manifest-declared OCI image configuration (architecture, OS, entrypoint, env vars) and the size in bytes of each layer as listed in the registry manifest. These are registry-declared values, not compressed download sizes or vulnerability scan results.","failureModes":["Image repository path does not match expected pattern — returns validation error","Reference (tag/branch) not found in registry — returns 404-equivalent error","Registry is private or rate-limits unauthenticated access — returns access denied or timeout","Malformed image string with uppercase characters or invalid registry format — rejected by schema pattern","Registry returns an unexpected manifest format — partial or empty layer list returned"],"whenToPreferThis":"Use this endpoint when you need to know a container image's declared layer sizes and OCI config metadata before committing to a pull, especially in bandwidth-constrained or storage-limited environments. Prefer it over actually pulling the image when the goal is pre-flight size inspection, CI/CD gating on image weight, or comparing base image options. Not suitable for vulnerability scanning, compressed download size estimation, or private registry access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T01:26:48.933Z","isFirstParty":false,"canonicalSlug":"forest-containers-oci-image-size-inspector-0615fde0"}