{"uid":"cap_77YrOyxkvEcU-EG2x3Fck","slug":"forest-web-openapi-operation-existence-check-fb208754","name":"Forest Web – OpenAPI Operation Existence Check","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/openapi/operation-resolve?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j_HWUgtI-sOs7FCUBvOdb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-build API contract verification","prompt":"Before I start integrating, can you check whether GET /v2/accounts/{id}/balances is actually documented in the OpenAPI spec at https://bank.example.com/openapi.yaml? I don't want to build against an undocumented endpoint."},{"title":"Automated SDK compatibility check","prompt":"Our SDK relies on DELETE /subscriptions/{subscriptionId} — can you verify that this DELETE operation is listed in the public Swagger contract at https://api.saas-provider.com/swagger.json so I know we're coding against a real documented route?"},{"title":"API governance audit for missing routes","prompt":"We think PATCH /users/{id}/profile should be in our API spec but I'm not sure — check the OpenAPI contract at https://internal-docs.example.com/openapi.json and tell me if that PATCH endpoint is actually documented there."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:36:16.150Z","isFirstParty":false,"canonicalSlug":"forest-web-openapi-operation-existence-check-fb208754"}