breakra

Live on Bankr · Base OpenAPI 3.0 · x402 · $0.02 / call

Know what changed before your integration breaks.

Compare two OpenAPI contracts. Get every breaking change, the evidence and a recommended fix. Built for coding agents.

Read the docs View on GitHub

POST https://x402.bankr.bot/0xb98f0de777eea8c481b64e33d3e0066cea38fa91/breakra-analyze

Real example

requestexamples/request.json (excerpt)
{
  "before": {
    "openapi": "3.0.3",
    "paths": { "/orders": { "get": {
      "parameters": [ { "name": "limit", … } ]
    } }, … }
  },
  "after": {
    "openapi": "3.0.3",
    "paths": { "/orders": { "get": {
      "parameters": [ { "name": "limit", … },
        { "name": "customer_id", "in": "query",
          "required": true, … } ]
    } }, … }
  }
}
response · 200examples/response.json (excerpt)
{
  "compatibility": "breaking",
  "summary": { "total_changes": 15, "breaking": 1,
               "potentially_breaking": 10, … },
  "changes": [ …, {
    "id": "change-002",
    "compatibility": "potentially_breaking",
    "operation": { "method": "GET", "path": "/orders" },
    "location": { "in": "query", "name": "customer_id" },
    "reason": "A new required query parameter `customer_id` was added to GET /orders. Callers that do not send it may be rejected.",
    "recommended_action": "Update callers of GET /orders to send `customer_id`."
  }, … ]
}

Breaking Potentially breaking Compatible Same inputs → same analysis_id. Full output ↗

curl -i -X POST -H 'content-type: application/json' --data @examples/request.json https://x402.bankr.bot/0xb98f0de777eea8c481b64e33d3e0066cea38fa91/breakra-analyze

Without payment this returns 402 with the x402 terms. Pay with any x402 client, or the one in examples/client.ts.

How it works

  1. 01

    Send two contracts

    The old and new OpenAPI 3.0 JSON, inline, in one POST.

  2. 02

    Pay $0.02 via x402

    Check the terms, sign once. Errors are never charged.

  3. 03

    Fix what may break

    Every change with its rule, location, evidence and a recommended fix.

Details

Input
OpenAPI 3.0.0–3.0.4 JSON, inline, ≤ 1 MB
Price
$0.02 USDC on Base, only on a 200
Output
breaking · potentially_breaking · unknown · compatible · non_contract
Results
Deterministic: the same inputs always give the same findings
Privacy
Specs are never stored or logged; external $refs are never fetched
Agents
Point your agent at breakra.dev/skill.md: when to call, how to pay safely, how to read results. Contract: /openapi.json