{"uid":"cap_4rFYCe7YrQROVxEBkwuLJ","slug":"agentreadiness-openapi-discovery-decision-8b4b8606","name":"AgentReadiness OpenAPI Discovery Decision","description":"OpenAPI discovery decision 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-decision?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_qdKKHPFk8yTr1hOLjH918","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 inspects a public URL or domain to evaluate whether a valid, discoverable OpenAPI specification is present and returns a structured verdict with evidence, threshold, and recommended action.","exampleAgentPrompt":"Can you check whether https://api.example.com has a publicly discoverable OpenAPI spec — I want to know if it's agent-ready and what evidence you found?","exampleUseCases":[{"title":"Pre-integration API discoverability check","prompt":"Before I integrate with stripe.com, can you check if they publish a discoverable OpenAPI spec so I know if my agent can auto-configure against it?"},{"title":"Agent-readiness audit for internal service","prompt":"We just deployed our new service at https://internal-api.mycompany.com — can you verify whether its OpenAPI documentation is publicly accessible and give me the verdict and evidence source?"},{"title":"Competitive API discovery comparison","prompt":"Compare https://api.service-a.com and https://api.service-b.com to see which one has better OpenAPI discoverability — I want to know which is more agent-ready."}],"resultDescription":"Returns a structured evaluation containing: an observation (what was found at the target), a threshold (what was required to pass), a binary or graded verdict (pass/fail), the exact evidence source URL, known limitations of the passive check, and a mode-specific recommended action — all without performing any login, payload injection, or intrusive testing.","failureModes":["Target URL is unreachable or returns non-200 status — verdict will reflect inability to retrieve evidence","Target has no publicly accessible OpenAPI spec — returns a 'fail' verdict with observation of absence","Malformed or invalid target URL — likely a 400-level validation error","Rate limiting or network timeouts on the target — observation may be incomplete","Target serves an OpenAPI spec behind authentication — passive check cannot access it, limitation noted in response"],"whenToPreferThis":"Choose this endpoint when you need a fast, passive, read-only check of whether a given public URL or domain exposes a discoverable OpenAPI specification — especially useful before attempting automated API integration, agent onboarding, or agent-readiness audits. Prefer it over generic crawlers when you specifically need an OpenAPI/Swagger presence verdict with structured evidence and a recommended remediation action.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:01.700Z","isFirstParty":false,"canonicalSlug":"agentreadiness-openapi-discovery-decision-8b4b8606"}