# Forest Agent Tools – Apify Actor Preflight

> Forest Agent Tools – Apify Actor Preflight is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-16).

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.

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/automation/preflight?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-agent-tools-apify-actor-preflight-2f9bed3c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4GxYScawwAkuTWIK4TnAr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forest-agent-tools-apify-actor-preflight-2f9bed3c -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## 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 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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-agent-tools-apify-actor-preflight-2f9bed3c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run](https://www.zero.xyz/host/http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/llms.txt)