{"uid":"cap_V8MU9eb1Pr31LoB_HDA7w","slug":"openapi-security-summary-resolver-d7d5c53d","name":"OpenAPI Security Summary Resolver","description":"Resolve authentication requirements across an OpenAPI 3.x or Swagger 2.x document. Returns the catalog of security schemes (`components.securitySchemes` in OpenAPI 3, `securityDefinitions` in Swagger 2) verbatim, the document-level default, and the *effective* security for each operation after layering.","url":"https://agent402.tools/api/openapi-security-summary","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"spec":{"description":"OpenAPI/Swagger document (object or JSON string)"}}},"responseSchema":{"type":"json","example":{"schemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"summary":{"schemes":1,"operations":3,"schemeUsage":{"bearerAuth":2},"openOperations":1,"securedOperations":2},"operations":[{"open":true,"path":"/public","method":"GET","security":[]},{"open":false,"path":"/users","method":"GET","security":[{"bearerAuth":[]}]},{"open":false,"path":"/admin","method":"POST","security":[{"bearerAuth":["admin"]}]}],"globalSecurity":[{"bearerAuth":[]}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Iz9oAyMDzAGIV3cRQEq0i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses an OpenAPI 3.x or Swagger 2.x document and returns a structured summary of all security schemes, document-level defaults, and per-operation authentication requirements","exampleAgentPrompt":"Can you analyze this OpenAPI spec and tell me all the security schemes it defines, what the document-level auth defaults are, and which individual operations have their own auth requirements? Here's the spec: {paste OpenAPI JSON/object here}.","exampleUseCases":null,"resultDescription":"Returns the full catalog of security schemes (components.securitySchemes for OpenAPI 3 or securityDefinitions for Swagger 2) verbatim, the document-level default security requirements, and per-operation authentication overrides — giving a complete picture of the API's authentication configuration.","failureModes":["Invalid or unparseable OpenAPI/Swagger document returns an error","Missing 'spec' field in request body returns a validation error","Malformed JSON string that cannot be parsed returns a parse error","Document with no security schemes returns an empty catalog","Unsupported spec version (e.g. OpenAPI 1.x) may return an error or unexpected output"],"whenToPreferThis":"Use this endpoint when you need to programmatically understand the authentication requirements of an OpenAPI or Swagger document — especially useful before generating client code, configuring API gateways, building auth middleware, or auditing APIs for security coverage. Prefer this over manual parsing when you need a structured, normalized view of all security definitions in a single call.","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}