{"uid":"cap_P2tTMvMqjbEpTQXb486wH","slug":"aizamon-openapi-spec-linter-4542f86a","name":"Aizamon OpenAPI Spec Linter","description":"Aizamon is an operator-run Canadian shop: $5 emailed security summaries via Stripe, Tor tooling for Cursor, and redacted developer telemetry. Named support. Clear terms.","url":"https://aizamon.com/x402/v1/spec-lint?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"OpenAPI JSON. Checks version, paths, and one 2xx response."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ok":{"type":"boolean"},"sku":{"type":"string"},"result":{"type":"object"},"protocol":{"type":"string"}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"ok":true,"sku":"SKU_AG_SPEC_01","result":{"openapi":{"score":2,"issues":["missing 2xx response"]}},"protocol":"x402"}},"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_7FXmH3LxLu3VjGET624CK","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":"Validates an OpenAPI JSON specification by checking version, paths, and presence of at least one 2xx response, returning a structured lint score and issue list.","exampleAgentPrompt":"Can you lint this OpenAPI JSON for me and tell me what's wrong with it? I want to know if it has valid version info, correct paths, and at least one 2xx response defined.","exampleUseCases":[{"title":"Pre-publish API spec audit","prompt":"Before I publish my new API, can you run this OpenAPI JSON through the Aizamon spec linter and tell me the score and any issues it finds? Here's the JSON: {\"openapi\":\"3.0.0\",\"info\":{\"title\":\"My API\"},\"paths\":{\"/users\":{\"get\":{\"responses\":{\"200\":{\"description\":\"ok\"}}}}}}."},{"title":"Catch missing 2xx response in spec","prompt":"I think my OpenAPI spec might be missing a success response definition — can you validate this JSON and tell me if it flags a 'missing 2xx response' issue?"},{"title":"CI pipeline spec quality check","prompt":"As part of my build process, I need to validate this OpenAPI spec JSON and get back a lint score — if the score is below 3 or there are any issues listed, flag it for me so I can fix it before merging."}],"resultDescription":"A JSON object containing: 'ok' (boolean success flag), 'sku' (SKU_AG_SPEC_01), 'protocol' (x402), and 'result.openapi' with a numeric score and an array of issue strings describing problems found (e.g. 'missing 2xx response', version errors, path problems).","failureModes":["Missing or invalid 'q' query parameter returns an error","Non-JSON or malformed OpenAPI input may produce a low score with multiple issues","Network or payment settlement failure returns a 402 Payment Required","Empty or null OpenAPI JSON may fail schema validation before linting begins"],"whenToPreferThis":"Choose this endpoint when you need a quick, cheap ($0.02) automated lint pass on an OpenAPI JSON document — especially to verify version field, path structure, and presence of 2xx responses. Ideal for CI pipelines, pre-publish checks, or agent workflows that generate OpenAPI specs and need to self-validate. Not a full schema compliance tool; use it for rapid structural checks rather than exhaustive validation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T18:42:33.655Z","isFirstParty":false,"canonicalSlug":"aizamon-openapi-spec-linter-4542f86a"}