{"uid":"cap_4GxYScawwAkuTWIK4TnAr","slug":"forest-agent-tools-apify-actor-preflight-2f9bed3c","name":"Forest Agent Tools – Apify Actor 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/automation/preflight?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"actor":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,63}[~/][A-Za-z0-9][A-Za-z0-9._-]{0,127}$","maxLength":193,"minLength":3,"description":"Public actor value used to scope this lookup."},"input":{"type":"object","description":"Public input value used to scope this lookup.","additionalProperties":true},"max_charge_usd":{"type":"number","maximum":10000,"description":"Public max charge usd value used to scope this lookup.","exclusiveMinimum":0}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"scope":"public_apify_metadata_only_no_actor_run","state":"ready","title":"example","notice":"example","summary":"example","actor_id":"example","blockers":[],"warnings":[],"actor_slug":"example","deprecated":false,"event_prices":[],"pricing_model":"example","max_charge_usd":1,"enum_mismatches":[],"output_surfaces":[],"type_mismatches":[],"budget_compatible":false,"unexpected_fields":[],"required_input_fields":[],"provider_request_count":1,"missing_required_fields":[],"primary_event_price_usd":1,"provider_request_budget":2,"agentic_payment_eligible":false,"input_contract_available":false,"minimum_charge_limit_usd":1,"estimated_runtime_seconds":1,"estimated_total_charge_usd":1,"additional_properties_allowed":false,"platform_usage_separately_charged":false},"meta":{"cache":"miss","provider":"apify-public-metadata","checked_at":"2026-01-01T00:00:00.000Z","duration_ms":0},"version":"1","capability":"automation.preflight"}},"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_7UHIWCTVygmFj_uRZzW06","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":"Checks an Apify Actor's agentic-payment eligibility, pricing/budget signals, and input compatibility before running a paid automation, without starting the Actor or spending credits.","exampleAgentPrompt":"Before I run the apify/web-scraper actor with my crawl input and a $5 budget cap, do a preflight check to confirm it's eligible for agentic payment, the pricing is within budget, and my input is compatible — without actually starting the run.","exampleUseCases":[{"title":"Budget check before scraping job","prompt":"I want to run the apify/instagram-scraper actor with my hashtag input and a max charge of $2 — can you do a preflight to confirm the pricing fits my budget and my input is valid before I kick it off?"},{"title":"Agentic payment eligibility screening","prompt":"Before my automation pipeline triggers the apify/web-crawler actor, check whether it's eligible for agentic payment and whether a $10 max budget is sufficient, using this input object: {\"startUrls\":[{\"url\":\"https://example.com\"}]}."},{"title":"Input compatibility validation for actor","prompt":"I'm about to run apify/cheerio-scraper with a custom input but I'm not sure my fields are correct — can you do a preflight against that actor to check input compatibility without actually starting anything or spending any credits?"}],"resultDescription":"Returns a preflight report covering agentic-payment eligibility, pricing and budget signals relative to the provided max_charge_usd, and whether the supplied input is compatible with the Actor's public input schema — all derived from public Apify Store and default-build OpenAPI metadata, with no Actor execution or credit deduction.","failureModes":["Actor identifier does not match the required pattern or is unknown in the public Apify Store","max_charge_usd is zero or negative (schema requires exclusiveMinimum: 0)","Actor has no public OpenAPI or Store metadata available, making preflight impossible","Input object contains fields that conflict with the Actor's public schema, flagged as incompatible","Service returns an error if the Apify Store is temporarily unavailable","Ambiguous or private Actors may return incomplete eligibility signals"],"whenToPreferThis":"Use this endpoint when an AI agent needs to gate an Apify Actor automation behind a pre-execution safety check — specifically to verify payment eligibility, ensure the budget cap is realistic, and confirm input compatibility before committing to a run. Prefer it over directly launching an Actor when cost control, input validation, or agentic-payment compliance is required. It is the right choice when you want a read-only, no-cost, no-side-effect screening step in an automation pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:36:55.303Z","isFirstParty":false,"canonicalSlug":"forest-agent-tools-apify-actor-preflight-2f9bed3c"}