{"uid":"cap_z70MdckoLFb1m5Mb9aMWk","slug":"openapi-discovery-repair-plan-ddecc7d1","name":"OpenAPI Discovery Repair Plan","description":"OpenAPI discovery repair plan fetches current public evidence from the supplied target and evaluates the documented criterion. It returns the observation, threshold, verdict, exact evidence source, limitations and a mode-specific action. The check is passive: no login attempt, payload injection, exploit, purchase, form submission or load test is performed.","url":"https://agentreadiness.halowerk.com/v1/openapi-discovery-repair?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"target":{"type":"string","maxLength":2048,"minLength":3,"description":"Public HTTP(S) URL or domain to inspect. A bare domain is normalized to HTTPS."},"context":{"type":"object","description":"Optional non-secret correlation labels returned unchanged only in the request lifecycle.","maxProperties":12,"additionalProperties":{"type":["string","number","boolean","null"]}},"baseline":{"type":["object","null"],"description":"Optional baseline returned by a previous snapshot call.","additionalProperties":true},"compare_url":{"type":"string","maxLength":2048,"minLength":3,"description":"Optional public comparison URL. Used by change and monitoring services."}}},"responseSchema":null,"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_Ezz5pX-mmVD1p2c5-wquQ","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":"Fetches public evidence from a target URL and evaluates whether its OpenAPI spec is discoverable, returning a verdict, evidence, and a concrete repair action.","exampleAgentPrompt":"Check whether my API at api.mycompany.com has a publicly discoverable OpenAPI spec, tell me what evidence you found, and give me a specific repair plan if it's not properly set up.","exampleUseCases":[{"title":"Fix missing OpenAPI spec on new API","prompt":"My API at api.startupxyz.com doesn't seem to be discoverable by AI agents — can you check if there's a valid OpenAPI spec exposed and tell me exactly what I need to fix?"},{"title":"Pre-launch agent readiness check","prompt":"Before we go live, I want to make sure agents can discover our API docs — please audit https://platform.acme.io for OpenAPI discoverability and give me a repair plan if anything is wrong."},{"title":"Diagnose why agent integration broke","prompt":"Our agent integration stopped working and I think it might be an OpenAPI discovery issue — can you evaluate https://api.legacyapp.net and tell me what the problem is with specific steps to resolve it?"}],"resultDescription":"Returns a structured result including: the observation (what was found at the target), the threshold used for the criterion, a pass/fail verdict, the exact evidence source URL, any limitations of the passive check, and a mode-specific action plan for repairing OpenAPI discoverability issues.","failureModes":["Target URL is unreachable or returns non-2xx — check returns an error or inconclusive verdict","Target domain is private or behind authentication — evidence cannot be fetched passively","Malformed or too-short target URL — request rejected by schema validation","OpenAPI spec exists but is dynamically generated and not at a standard path — may return false negative","Rate limits or network timeouts may cause transient failures"],"whenToPreferThis":"Use this endpoint when you need a concrete, actionable repair plan specifically for OpenAPI spec discoverability — not just a pass/fail audit. It is ideal when a previous audit has flagged an OpenAPI discovery issue and you need the next step: what exactly to fix and how. Prefer sibling audit endpoints when you only need a verdict without remediation guidance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:58.098Z","isFirstParty":false,"canonicalSlug":"openapi-discovery-repair-plan-ddecc7d1"}