{"uid":"cap_bB_5Fuv4ygmjZgjxmdx_S","slug":"openapi-contract-audit-2e50dcbf","name":"OpenAPI Contract Audit","description":"Audit an inline OpenAPI 3.0 or 3.1 JSON document for contract completeness and consistency. Returns a deterministic 0-100 score, bounded issue list, operation and schema inventory, duplicate operation IDs, missing summaries/responses, path-parameter defects, undefined security schemes, and unresolved local references.","url":"https://api.ikoles.dev/v1/openapi-audit","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"document":{"type":"object","description":"Inline OpenAPI 3.0 or 3.1 JSON document; external references are not fetched"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_smrtGgumNwRms2DwmM_4r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits an inline OpenAPI 3.0/3.1 JSON document for contract completeness and consistency, returning a deterministic 0-100 score plus a detailed issue list.","exampleAgentPrompt":"Can you audit this OpenAPI 3.1 spec for me and give it a completeness score? I want to know about any missing response definitions, duplicate operation IDs, undefined security schemes, or unresolved local references.","exampleUseCases":[{"title":"Pre-publish API contract check","prompt":"Before I publish this API, can you run a full audit on this OpenAPI 3.0 JSON and tell me the completeness score plus any missing summaries, broken path parameters, or undefined security schemes I need to fix?"},{"title":"CI pipeline spec quality gate","prompt":"I need to validate my OpenAPI spec as part of our CI process — can you score it from 0-100 for contract completeness and list every issue including duplicate operation IDs and unresolved local references?"},{"title":"Third-party API spec review","prompt":"I just received this OpenAPI 3.1 document from a vendor — can you audit it and tell me how complete it is, whether any operations are missing response definitions, and if there are any inconsistent path parameters?"}],"resultDescription":"Returns a deterministic 0-100 completeness score, a bounded list of issues categorized by type (missing summaries, missing responses, path-parameter defects, undefined security schemes, unresolved local references, duplicate operation IDs), and an inventory of all operations and schemas found in the document.","failureModes":["Invalid or malformed JSON document returns a parsing error","External references are not fetched and will be flagged as unresolved","OpenAPI versions other than 3.0 or 3.1 may produce incomplete results","Very large documents may hit payload size limits","Missing required 'document' field returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, reproducible quality score for an OpenAPI 3.0 or 3.1 contract and want a structured breakdown of specific defects (missing responses, duplicate IDs, bad path params, undefined security, unresolved refs) rather than a general linting pass. Ideal for CI/CD gates, API governance workflows, or reviewing third-party specs before integration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:48:50.679Z","isFirstParty":false}