← capabilities

Openapi Operation-contract

Inspect the declared request and response contract for one exact OpenAPI or Swagger operation before integration. Returns parameters, request-body content types, response statuses/content types and declared security scheme names without executing the endpoint or resolving external references.

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.003 / callPOST /openapi/operation-contractx402 · 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/openapi.json", "method": "POST", "path": "/widgets" }

Canonical paid endpoint

https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/openapi/operation-contract

OpenAPI contract →

Related capabilities