← capabilities

Web Url-preflight

Preflight one public URL before an agent uses it: verify immediate HTTP reachability, origin status, redirect destination, response headers and cache validators with a bounded HEAD-first probe. GET is used only when HEAD is unsupported. No JavaScript, login, page extraction or availability guarantee.

Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.

$0.001 / callPOST /url/preflightx402 · Base

Typical agent tasks

This capability is intended for bounded machine decisions such as:

What Forest guarantees

Boundaries

Machine contract

The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.

Input example

{ "url": "https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/health" }

Canonical paid endpoint

https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/url/preflight

OpenAPI contract →

Related capabilities