# BRAINIAC Version Compatibility Check

> BRAINIAC Version Compatibility Check is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Checks whether a JSON payload or schema is compatible between two API versions, identifying breaking and non-breaking changes.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/integration/version-compatibility-check?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-version-compatibility-check-381b5d26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e0wjR0Ra6qK4mecUTRjVI

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 brainiac-version-compatibility-check-381b5d26 -d '<json body>'
```

Example prompt: Check whether my JSON payload is still compatible after the API upgraded from version 1.2.0 to 1.3.0 — here's the payload: {"total": 42.5, "items": []}. Tell me which changes are breaking and which aren't, and treat it as a response-side check.

## When to prefer this

Use this endpoint when you need a fast, pay-per-call, accountless check of JSON schema or payload compatibility across two API versions, especially for detecting breaking changes like newly required fields, type changes, or property removals. Prefer it over manual diffing or heavier CI tools when you want a structured, machine-readable result with labeled breaking vs non-breaking changes without setting up infrastructure.

## Known failure modes

- Unsupported JSON Schema keywords are reported but not applied, potentially missing some incompatibilities
- Schema generated from examples only captures observed values; additionalProperties defaults to true
- Field mapping proposals only made when path or field name matches exactly on both sides
- Breaking/non-breaking labels only returned when 'side' is explicitly set to 'request' or 'response'
- Malformed base64 file input or oversized payloads may be rejected
- Only a subset of formats validated: email, date, date-time — other formats are ignored

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with: a 'compatible' boolean, a 'status' string (e.g. 'incompatible'), ordered 'changes' array with code, path, before/after values, detail, and 'breaking'/'non-breaking' effect labels, an 'issues' array with type mismatches or violations, 'payloadStatus', 'schemaCompliance' flag, 'codeExecuted' and 'externalCall' booleans confirming no side effects, 'fromVersion'/'toVersion', and a 'limitations' array describing what JSON Schema keywords are and aren't evaluated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "application/json",
      "text/plain"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "side": {
   "enum": [
    "request",
    "response"
   ],
   "type": "string"
  },
  "after": {},
  "before": {},
  "schema": {},
  "source": {},
  "target": {},
  "example": {},
  "payload": {},
  "examples": {
   "type": "array",
   "items": {},
   "maxItems": 20
  },
  "toVersion": {
   "type": "string",
   "maxLength": 40,
   "minLength": 1
  },
  "operations": {
   "type": "array",
   "items": {
    "oneOf": [
     {
      "type": "object",
      "required": [
       "op",
       "from",
       "to"
      ],
      "properties": {
       "op": {
        "type": "string",
        "const": "rename"
       },
       "to": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
       },
       "from": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
       }
      },
      "additionalProperties": false
     },
     {
      "type": "object",
      "required": [
       "op",
       "from",
       "to"
      ],
      "properties": {
       "op": {
        "type": "string",
        "const": "copy"
       },
       "to": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
       },
       "from": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
       }
      },
      "additionalProperties": false
     },
     {
      "type": "object",
      "required": [
       "op",
       "paths"
      ],
      "properties": {
       "op": {
        "type": "string",
        "const": "pick"
       },
       "paths": {
        "type": "array",
        "items": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        },
        "maxItems": 40,
        "minItems": 1
       }
      },
      "additionalProperties": false
     },
     {
      "type": "object",
      "required": [
       "op",
       "paths"
      ],
      "properties": {
       "op": {
        "type": "string",
        "const": "omit"
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "order": "newer",
  "issues": [
   {
    "code": "type_mismatch",
    "kind": "conflict",
    "path": "/total",
    "detail": "The value is number. The schema allows integer.",
    "keyword": "type"
   }
  ],
  "status": "incompatible",
  "changes": [
   {
    "code": "required_added",
    "path": "/total",
    "after": "total",
    "before": "",
    "detail": "This property is newly required.",
    "effect": "breaking"
   },
   {
    "code": "type_changed",
    "path": "/total",
    "after": "integer",
    "before": "number",
    "detail": "The type allows fewer values.",
    "effect": "breaking"
   }
  ],
  "checkedAt": "2026-11-03T15:00:00.000Z",
  "toVersion": "1.3.0",
  "compatible": false,
  "fromVersion": "1.2.0",
  "limitations": [
   "No external API is called and no user-supplied code is executed.",
   "Validation covers type, properties, required, additionalProperties, items, enum, const, length, range, and the formats email, date, and date-time. Other JSON Schema keywords are reported and not applied.",
   "A generated schema uses only values present in the supplied examples. additionalProperties stays true.",
   "A field mapping is proposed only when the path matches or the field name matches one field on each side.",
   "Breaking and non-breaking labels are returned only when side is request or response.",
   "Transforms are rename, copy, pick, omit, cast, and default. A default is written only when the path is absent."
  ],
  "codeExecuted": false,
  "externalCall": false,
  "payloadStatus": "invalid",
  "valuesInvented": false,
  "schemaCompliance": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-version-compatibility-check-381b5d26/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
