{"uid":"cap_GJlPg2bknXh6Z6LSnOFTx","slug":"agent402-tools-openapi-required-params-extractor-83822cb4","name":"agent402.tools OpenAPI Required Params Extractor","description":"For one operation, return the minimum set of inputs an agent must provide to make a successful call. Locate the op by `operationId` (preferred) or by `method`+`path`. Output is a single flat array tagged by `in`: `path` (always required), `query` / `header` / `cookie` (only when `required: true`), and `body.field` entries naming the top-level required fields of a required JSON request body.","url":"https://agent402.tools/api/openapi-required-params","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"path":{"description":"If no operationId, exact path (e.g. /users/{id})"},"spec":{"description":"OpenAPI/Swagger document (object or JSON string)"},"method":{"description":"If no operationId, HTTP method (e.g. GET)"},"operationId":{"description":"Locate by operationId (preferred)"}}},"responseSchema":{"type":"json","example":{"path":"/users","method":"POST","hasBody":true,"required":[{"in":"body.field","name":"email","type":"string"},{"in":"body.field","name":"password","type":"string"}],"operationId":"createUser","bodyContentType":"application/json"}},"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_6q8nC118dslIW1IXLVvLf","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":"Given an OpenAPI spec and an operation identifier, returns the minimum set of required input parameters an agent must supply to make a valid call.","exampleAgentPrompt":"I have this OpenAPI spec as a JSON object — can you tell me the minimum required parameters I need to provide to call the operation with operationId 'createUser', tagged by whether they go in the path or query?","exampleUseCases":null,"resultDescription":"A flat array of required parameter objects, each tagged with their location (e.g. 'path', 'query', 'header', 'body'), representing only the minimum inputs needed to make a successful call to the specified operation.","failureModes":["operationId not found in spec — returns error or empty result","invalid or malformed OpenAPI/Swagger document — parsing failure","neither operationId nor method+path provided — ambiguous lookup","method+path combination does not match any operation — not found","spec passed as invalid JSON string — parse error"],"whenToPreferThis":"Use this endpoint when an agent needs to programmatically determine the minimum required inputs for any operation in an OpenAPI spec, especially before attempting to call an unknown API. Ideal for dynamic API orchestration, agent tooling pipelines, or when building adapters that need to introspect API contracts without manual inspection.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:06.181Z","isFirstParty":false}