{"uid":"cap_ZPMATo6OJDehXwpLz1uTm","slug":"brainiac-version-compatibility-check-a314472a","name":"BRAINIAC Version Compatibility Check","description":"Pay-per-call APIs for software agents. No account. Pay the listed USDC amount on Base with x402, then receive the result.","url":"https://www.brainiac.software/api/v1/api-integration/version-compatibility-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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},"maxItems":40,"minItems":1}},"additionalProperties":false},{"type":"object","required":["op","paths"],"properties":{"op":{"type":"string","const":"omit"},"paths":{"type":"array","items":{"type":"string","maxLength":200,"minLength":1},"maxItems":40,"minItems":1}},"additionalProperties":false},{"type":"object","required":["op","path","type"],"properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","maxLength":200,"minLength":1},"type":{"enum":["string","number","integer","boolean"],"type":"string"}},"additionalProperties":false},{"type":"object","required":["op","path","value"],"properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","maxLength":200,"minLength":1},"value":{"$ref":"#/$defs/__schema0"}},"additionalProperties":false}]},"maxItems":40},"fromVersion":{"type":"string","maxLength":40,"minLength":1}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NzDe1Lm-ZA4ukbCVVZzTd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a JSON payload or schema is compatible between two API versions and identifies breaking/non-breaking changes","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Detect breaking changes before API migration","prompt":"I'm about to migrate from API version 2.1.0 to 2.3.0 — can you check if this JSON schema I'm sending as a request will still be compatible, and flag any breaking changes? Here's the schema: {\"type\":\"object\",\"properties\":{\"userId\":{\"type\":\"string\"},\"amount\":{\"type\":\"number\"}},\"required\":[\"userId\"]}."},{"title":"Validate response payload against new schema","prompt":"Our backend just updated to v1.4.0 and I want to make sure our existing response payloads won't break. Can you check this response-side JSON payload against the new version and tell me if there are any type mismatches or new required fields?"},{"title":"Check field rename impact on API compatibility","prompt":"We're renaming the field 'total_price' to 'totalAmount' in our API going from version 3.0 to 3.1 — can you check if that rename operation on the response side will be a breaking change and show me what issues it creates?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:37:20.340Z","isFirstParty":false,"canonicalSlug":"brainiac-version-compatibility-check-a314472a"}