# OpenAPI Discovery Repair Plan

> OpenAPI Discovery Repair Plan 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).

Fetches public evidence from a target URL and evaluates whether its OpenAPI spec is discoverable, returning a verdict, evidence, and a concrete repair action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/openapi-discovery-repair?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/openapi-discovery-repair-plan-ddecc7d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z70MdckoLFb1m5Mb9aMWk

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 openapi-discovery-repair-plan-ddecc7d1 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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/openapi-discovery-repair-plan-ddecc7d1/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)