# AgentReadiness OpenAPI Discovery Audit

> AgentReadiness OpenAPI Discovery Audit is a paid API for AI agents from agentreadiness.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Passively audits a public URL or domain to evaluate whether its OpenAPI specification is discoverable and correctly documented for AI agent consumption.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/openapi-discovery-audit?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentreadiness-openapi-discovery-audit-67b9e803
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DBmjrUJmSThjBfqG-Mmke

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentreadiness-openapi-discovery-audit-67b9e803 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentreadiness-openapi-discovery-audit-67b9e803/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreadiness.halowerk.com](https://www.zero.xyz/host/agentreadiness.halowerk.com/llms.txt)