{"uid":"cap_FLwtF0hlAZE4bcEZAikGA","slug":"openapi-contract-audit-safe-pytest-scaffold-c67f658d","name":"OpenAPI Contract Audit + Safe Pytest Scaffold","description":"Audit one public OpenAPI 3.x JSON or YAML document and receive prioritized contract findings, a quality score, a Markdown handoff, and a safe read-only pytest scaffold.","url":"https://codex-rapid-patch-evidence.vercel.app/api/rapid-patch-pack?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"need":{"type":"string","description":"Short description of the public, credential-free engineering task."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"name":{"type":"string"},"download":{"type":"object","properties":{"bugfixTriageCli":{"type":"string"},"productManifest":{"type":"string"},"apiContractEvidenceCli":{"type":"string"}}},"includes":{"type":"array","items":{"type":"string"}}}}}}}},"responseSchema":{"type":"json","example":{"name":"Rapid Patch Evidence Pack","download":{"bugfixTriageCli":"/downloads/bugfix-triage.mjs","productManifest":"/downloads/product-manifest.json","apiContractEvidenceCli":"/downloads/api-contract-evidence.mjs"},"includes":["deterministic bugfix triage","API contract evidence","reviewer-ready patch handoff"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"15","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":"$15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-57Hl0KuBEGo7xsRORNSm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits a public OpenAPI 3.x JSON or YAML document and returns prioritized contract findings, a quality score, a Markdown handoff, and a read-only pytest scaffold.","exampleAgentPrompt":"Can you audit this public OpenAPI spec at https://petstore3.swagger.io/api/v3/openapi.json and give me prioritized contract findings, a quality score, a Markdown handoff, and a safe pytest scaffold I can run without any credentials?","exampleUseCases":[{"title":"Pre-release API contract review","prompt":"Before we ship, can you audit our public OpenAPI spec at https://api.mycompany.com/openapi.json and give me a prioritized list of contract issues plus a quality score so we can fix problems before release?"},{"title":"Generate read-only pytest scaffold","prompt":"I need a safe, credential-free pytest scaffold generated from our OpenAPI 3.x spec at https://api.example.com/v3/openapi.yaml — one I can hand off to the QA team to run immediately without any setup."},{"title":"Reviewer-ready Markdown handoff","prompt":"Can you produce a reviewer-ready Markdown handoff from auditing the OpenAPI spec at https://partner.service.io/openapi.json, including the contract findings and quality score, so I can share it in our PR review?"}],"resultDescription":"Returns a JSON object containing a named evidence pack with download links to: a bugfix triage CLI script, a product manifest JSON, and an API contract evidence CLI script. Also includes a list of what's in the pack: deterministic bugfix triage, API contract evidence, and a reviewer-ready patch handoff, along with prioritized contract findings, a quality score, and a Markdown handoff document.","failureModes":["Missing or invalid OpenAPI URL — returns error if the spec cannot be fetched or parsed","Non-public or credential-gated spec URL — endpoint cannot retrieve protected documents","Invalid OpenAPI version — only 3.x specs are supported; 2.x Swagger docs may fail","Malformed YAML/JSON — unparseable documents return a parse error","Payment failure — x402 payment of $15 USDC not completed results in 402 response","Unsupported HTTP method — only GET, HEAD, DELETE are accepted"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, automated audit of a public OpenAPI 3.x spec that produces not just findings but also actionable developer artifacts: a ready-to-run pytest scaffold, a Markdown handoff for code review, and a quality score. It is ideal when the spec is publicly accessible without credentials and you need a complete evidence pack for engineering handoff or PR review, rather than just a lint report.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:32:32.683Z","isFirstParty":false,"canonicalSlug":"openapi-contract-audit-safe-pytest-scaffold-f4af8574"}