# NewBotLabor OpenAPI Lint

> NewBotLabor OpenAPI Lint is a paid API for AI agents from newbotlabor--254ecdfcc2de11f19b541607ee4eb77e.web.val.run, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-22).

Validates and scores an OpenAPI document, returning a quality score, issue counts by severity, and a list of rule violations with paths and details.

## Facts

- Endpoint: POST https://newbotlabor--254ecdfcc2de11f19b541607ee4eb77e.web.val.run/api/openapi/lint?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/newbotlabor-openapi-lint-7ee6b1c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ncHzEJKtptd_X5ip93V1G

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 newbotlabor-openapi-lint-7ee6b1c0 -d '<json body>'
```

Example prompt: Can you lint my OpenAPI spec at https://api.myservice.com/openapi.json and tell me the quality score, any errors or warnings, and which operations are missing operationIds?

## When to prefer this

Choose this endpoint when you need a pay-per-call, no-account OpenAPI linting service that returns a structured quality score and machine-readable issue list — especially useful inside agent workflows that need to validate specs on the fly without managing API keys. Prefer this over manual spec review tools when you need programmatic output for downstream automation.

## Known failure modes

- Invalid or unreachable URL returns an error fetching the document
- Malformed JSON in the spec field causes a parse error
- Neither url nor spec provided results in a bad request response
- Very large OpenAPI documents may time out
- Non-OpenAPI JSON documents may return low scores or unexpected rule matches

## How this service works

Pay-per-call utilities for autonomous agents, paid with x402 (USDC on Base; no account, no API key).

## Output

A JSON object containing a numeric quality score (0–100), the API title, counts of info/warn/error issues, an array of issue objects (each with a JSON path, rule name, detail message, and severity), total operation count, OpenAPI version string, and count of paid operations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "URL of an OpenAPI JSON document"
  },
  "spec": {
   "type": "object",
   "description": "or the OpenAPI document itself"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "score": 84,
  "title": "My API",
  "counts": {
   "info": 6,
   "warn": 4,
   "error": 0
  },
  "issues": [
   {
    "path": "$.paths['/v1/x'].get",
    "rule": "operation-id",
    "detail": "missing operationId (SDK/agent tool names)",
    "severity": "warn"
   }
  ],
  "operations": 12,
  "openapiVersion": "3.1.0",
  "paidOperations": 4
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/newbotlabor-openapi-lint-7ee6b1c0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from newbotlabor--254ecdfcc2de11f19b541607ee4eb77e.web.val.run](https://www.zero.xyz/host/newbotlabor--254ecdfcc2de11f19b541607ee4eb77e.web.val.run/llms.txt)