# AgentReadiness OpenAPI Discovery Decision

> AgentReadiness OpenAPI Discovery Decision 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 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.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/openapi-discovery-decision?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-decision-8b4b8606
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4rFYCe7YrQROVxEBkwuLJ

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-decision-8b4b8606 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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-decision-8b4b8606/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)