{"uid":"cap_DBmjrUJmSThjBfqG-Mmke","slug":"agentreadiness-openapi-discovery-audit-67b9e803","name":"AgentReadiness OpenAPI Discovery Audit","description":"OpenAPI discovery audit 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-audit?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_Rptd6hdk_N33gcFI_9h8y","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":"Passively audits a public URL or domain to evaluate whether its OpenAPI specification is discoverable and correctly documented for AI agent consumption.","exampleAgentPrompt":"Can you run a passive OpenAPI discovery audit on api.mycompany.com and tell me whether our spec is publicly discoverable and what evidence you found?","exampleUseCases":[{"title":"Pre-launch API documentation check","prompt":"Before we go live, can you audit https://api.newstartup.io to see if our OpenAPI spec is properly discoverable — I want the verdict, what evidence was found, and any recommended actions?"},{"title":"Agent integration readiness review","prompt":"We're trying to make our platform agent-accessible — can you audit https://platform.mybusiness.com to check if our OpenAPI discovery passes the standard criteria and tell us what's missing?"},{"title":"Competitor API discoverability comparison","prompt":"Can you audit https://api.competitorsite.com and check whether their OpenAPI spec is publicly discoverable, then let me know the observation and verdict?"}],"resultDescription":"Returns a structured audit result including: the observed state of OpenAPI discoverability on the target, the evaluation threshold used, a pass/fail verdict, the exact evidence source (URL or header) found, any limitations of the passive check, and a mode-specific recommended action. No authentication, form submission, or active exploitation is performed.","failureModes":["Target URL is unreachable or returns non-2xx — audit cannot retrieve evidence","Target has no OpenAPI spec at any standard path — verdict will be fail with observation of absence","Malformed or non-HTTPS URL provided — normalization may fail or return validation error","Rate limiting or firewall on target blocks the passive fetch — limitations field will note restricted access","Baseline object malformed — comparison may be skipped or return an error"],"whenToPreferThis":"Choose this endpoint when you need a quick, passive, read-only check of whether a public API or website exposes a discoverable OpenAPI specification — without triggering any login, payload, or load on the target. Prefer it over general site crawlers when the specific criterion is OpenAPI discoverability and you want a structured verdict with evidence provenance. It is especially useful before integrating a third-party API into an agent workflow or before publishing your own API for agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:45.748Z","isFirstParty":false,"canonicalSlug":"agentreadiness-openapi-discovery-audit-67b9e803"}