{"uid":"cap_CJSQwgLuOwoZcWMEIPuyF","slug":"forest-web-openapi-swagger-operation-contract-inspector-623c8ded","name":"Forest Web – OpenAPI/Swagger Operation Contract Inspector","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-contract?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":"bounded_contract_metadata_only_no_operation_execution","version":"example","contract":{"path":"example","method":"example","responses":[],"deprecated":false,"parameters":[],"operation_id":"example","request_body":{"required":false,"content_types":[]},"security_source":"operation","detail_available":false,"security_schemes":[]},"requested":{"path":"example","method":"example"},"parse_valid":false,"detail_state":"available","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-contract"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kok6Tp5M4oU-ZzKQ-aMWG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the declared request/response contract (parameters, body content types, response statuses, security schemes) for one specific OpenAPI or Swagger operation without executing it or resolving external references.","exampleAgentPrompt":"Before I start integrating, can you inspect the declared contract for the POST /payments operation in the OpenAPI spec at https://api.example.com/openapi.yaml — tell me what parameters it expects, what request body content types it accepts, what response codes it declares, and what security schemes are required?","exampleUseCases":[{"title":"Pre-integration contract check","prompt":"I'm about to integrate with a third-party API — can you pull the declared contract for the GET /orders/{id} operation from https://api.commerce.example.com/openapi.json and tell me what path parameters it needs, what responses it can return, and whether it requires any security headers?"},{"title":"Security scheme discovery for an API op","prompt":"Before I wire up auth, what security schemes does the OpenAPI spec at https://platform.example.io/api-docs declare for the DELETE /accounts/{accountId} operation?"},{"title":"Response status code audit before deployment","prompt":"Can you check the OpenAPI spec at https://internal.example.com/swagger.yaml and tell me all the declared response status codes and their content types for the POST /invoices endpoint? I want to make sure I'm handling every possible response before we go live."}],"resultDescription":"A structured summary of the declared contract for the specified OpenAPI/Swagger operation, including: accepted request parameters (path, query, header, cookie), request body content types, declared HTTP response status codes with their content types, and the names of any declared security schemes. No live requests are made to the target endpoint; only the spec document is read.","failureModes":["URL does not point to a valid OpenAPI or Swagger document — returns an error indicating the spec could not be parsed","Specified path or method does not exist in the retrieved spec — returns a not-found or mismatch error","URL is unreachable or returns a non-200 response — returns a network or access error","Spec uses external $ref references that cannot be resolved without fetching additional documents — contract may be incomplete","Malformed or non-standard spec versions may result in partial or empty contract data"],"whenToPreferThis":"Choose this endpoint when you need to inspect the declared contract of one specific API operation (method + path) within a public OpenAPI or Swagger document before integration — without executing the endpoint, without resolving external references, and without crawling the full spec. Prefer this over a full spec fingerprinter when you only care about one operation's inputs, outputs, and security declarations rather than the entire API surface.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T11:35:51.637Z","isFirstParty":false,"canonicalSlug":"forest-web-openapi-swagger-operation-contract-inspector-623c8ded"}