# Forest Web – OpenAPI Operation Existence Check

> Forest Web – OpenAPI Operation Existence Check is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-20).

Looks up a specific HTTP method and path in a public OpenAPI/Swagger specification and reports whether that documented endpoint exists in the contract, without invoking the actual API.

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/openapi/operation-resolve?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-web-openapi-operation-existence-check-fb208754
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_77YrOyxkvEcU-EG2x3Fck

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-web-openapi-operation-existence-check-fb208754 -d '<json body>'
```

Example prompt: Check whether POST /payments/initiate is documented in the OpenAPI spec at https://api.example.com/openapi.json — I need to know if that operation actually exists in the contract before I build against it.

## When to prefer this

Use this endpoint when you need to confirm that a specific REST operation (method + path) is formally documented in a public OpenAPI or Swagger contract before building integrations, generating SDKs, running compliance checks, or validating API governance policies. It is ideal for pre-flight checks where you want contract-level truth without triggering the live API. Prefer it over general web scraping or manual spec inspection when you need a deterministic, machine-readable existence answer from a structured API specification.

## Known failure modes

- URL does not point to a valid OpenAPI/Swagger document — returns error or invalid contract response
- Specified path or method not found in the contract — returns non-existence result
- URL is unreachable or returns non-200 status — fetch failure
- Malformed or non-standard OpenAPI spec that cannot be parsed
- Path provided does not start with '/' — rejected by schema validation
- URL does not start with http:// or https:// — rejected by schema validation

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

A report indicating whether the specified HTTP method and path combination exists as a documented operation in the target public OpenAPI or Swagger contract. The result reflects the specification only — the actual live API is never called.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "pattern": "^https?://",
   "maxLength": 2048,
   "minLength": 1,
   "description": "Public HTTP(S) URL to inspect, resolve, or compare."
  },
  "path": {
   "type": "string",
   "pattern": "^/",
   "maxLength": 2048,
   "minLength": 1,
   "description": "Repository file path whose public metadata should be checked."
  },
  "method": {
   "enum": [
    "GET",
    "POST",
    "PUT",
    "PATCH",
    "DELETE",
    "HEAD",
    "OPTIONS",
    "TRACE"
   ],
   "type": "string",
   "description": "HTTP method for the bounded public probe."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "url": "example",
   "found": false,
   "scope": "contract_only_no_operation_execution",
   "version": "example",
   "operation": {
    "path": "example",
    "method": "example"
   },
   "requested": {
    "path": "example",
    "method": "example"
   },
   "parse_valid": false,
   "operation_count": 0
  },
  "meta": {
   "cache": "miss",
   "provider": "openapi-parser",
   "checked_at": "2026-01-01T00:00:00.000Z",
   "duration_ms": 0
  },
  "version": "1",
  "capability": "openapi.operation-resolve"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-web-openapi-operation-existence-check-fb208754/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)