# 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-17).

Checks whether a JSON payload or schema is compatible between two API versions and identifies breaking/non-breaking changes

## Facts

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

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-a314472a -d '<json body>'
```

Example prompt: Can you check whether this JSON payload is still compatible after upgrading from API version 1.2.0 to 1.3.0? Here's the payload: {"total": 99.5, "items": []}. The payload is used on the response side.

## When to prefer this

Use this endpoint when you need a fast, server-side, schema-aware compatibility check between two API versions without setting up tooling or running code locally. It's ideal for agents that need to validate payloads or detect breaking changes at runtime as part of an automated workflow, especially when no account or persistent session is needed. Prefer it over local diffing tools when you need structured output (change codes, effects, issues) that can be acted on programmatically.

## Known failure modes

- Invalid or malformed JSON input returns a parsing error
- File base64 exceeds maximum size (12MB) causes rejection
- Unsupported JSON Schema keywords are reported but not evaluated
- Schema generated from examples only reflects provided values — missing fields may not be detected
- Missing required fields (toVersion or schema reference) may cause incomplete results
- Version strings that don't follow a recognizable format may produce ambiguous comparisons

## How this service works

Pay-per-call APIs for software agents. No account. Pay the listed USDC amount on Base with x402, then receive the result.

## Output

Returns a JSON object with: compatible (boolean), status (e.g. 'incompatible'), fromVersion, toVersion, a list of changes (each with code, path, before/after values, detail, and breaking/non-breaking effect), a list of issues (type mismatches, etc.), payloadStatus, schemaCompliance, and a list of limitations describing what the checker does and does not cover. No external calls or code execution are made.

## 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": {
   "$ref": "#/$defs/__schema0"
  },
  "before": {
   "$ref": "#/$defs/__schema0"
  },
  "schema": {
   "$ref": "#/$defs/__schema0"
  },
  "source": {
   "$ref": "#/$defs/__schema0"
  },
  "target": {
   "$ref": "#/$defs/__schema0"
  },
  "example": {
   "$ref": "#/$defs/__schema0"
  },
  "payload": {
   "$ref": "#/$defs/__schema0"
  },
  "examples": {
   "type": "array",
   "items": {
    "$ref": "#/$defs/__schema0"
   },
   "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
        },
        
… (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-a314472a/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)
