{"openapi":"3.1.0","info":{"title":"API Integration Intelligence API","version":"1.0.0","description":"Validate supplied payloads against supplied contracts, map fields that exist on both sides, and apply a documented set of JSON transforms. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/integration/json-schema-generate":{"post":{"operationId":"generate_a_json_schema","summary":"Generate a JSON schema","description":"Build a schema from supplied examples. Required properties are keys present on every example. Whole numbers are integer. Additional properties stay allowed.","tags":["integration"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"$ref":"#/$defs/__schema0"},"example":{"$ref":"#/$defs/__schema0"},"examples":{"maxItems":20,"type":"array","items":{"$ref":"#/$defs/__schema0"}},"schema":{"$ref":"#/$defs/__schema0"},"source":{"$ref":"#/$defs/__schema0"},"target":{"$ref":"#/$defs/__schema0"},"before":{"$ref":"#/$defs/__schema0"},"after":{"$ref":"#/$defs/__schema0"},"json":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"operations":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"rename"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"copy"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"pick"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"omit"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["string","number","integer","boolean"]}},"required":["op","path","type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","minLength":1,"maxLength":200},"value":{"$ref":"#/$defs/__schema0"}},"required":["op","path","value"],"additionalProperties":false}]}},"side":{"type":"string","enum":["request","response"]},"fromVersion":{"type":"string","minLength":1,"maxLength":40},"toVersion":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"anyOf":[{"type":"string","maxLength":20000},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"maxItems":200,"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string","maxLength":120},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"example":{"example":{"id":"ord_1","email":"ada@example.com","total":12,"items":[{"sku":"press","qty":1}]}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"codeExecuted":{"type":"boolean"},"externalCall":{"type":"boolean"},"valuesInvented":{"type":"boolean"},"schemaCompliance":{"type":"boolean"},"status":{"type":"string"},"schemaGenerated":{"type":"boolean"},"schema":{"type":"object","properties":{"type":{"type":"string"},"properties":{"type":"object","properties":{"id":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true},"email":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true},"total":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true},"items":{"type":"object","properties":{"type":{"type":"string"},"items":{"type":"object","properties":{"type":{"type":"string"},"properties":{"type":"object","properties":{"sku":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true},"qty":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"required":{"type":"array","items":{"type":"string"}},"additionalProperties":{"type":"boolean"}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true},"required":{"type":"array","items":{"type":"string"}},"additionalProperties":{"type":"boolean"}},"additionalProperties":true},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T15:00:00.000Z","codeExecuted":false,"externalCall":false,"valuesInvented":false,"schemaCompliance":false,"status":"generated","schemaGenerated":true,"schema":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"total":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"qty":{"type":"integer"}},"required":["sku","qty"],"additionalProperties":true}}},"required":["id","email","total","items"],"additionalProperties":true},"issues":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/integration/json-schema-validate":{"post":{"operationId":"validate_a_payload","summary":"Validate a payload","description":"Check a payload against a supplied schema using the documented subset. Each failure has a JSON pointer. Unsupported keywords are reported and not applied.","tags":["integration"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"$ref":"#/$defs/__schema0"},"example":{"$ref":"#/$defs/__schema0"},"examples":{"maxItems":20,"type":"array","items":{"$ref":"#/$defs/__schema0"}},"schema":{"$ref":"#/$defs/__schema0"},"source":{"$ref":"#/$defs/__schema0"},"target":{"$ref":"#/$defs/__schema0"},"before":{"$ref":"#/$defs/__schema0"},"after":{"$ref":"#/$defs/__schema0"},"json":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"operations":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"rename"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"copy"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"pick"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"omit"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["string","number","integer","boolean"]}},"required":["op","path","type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","minLength":1,"maxLength":200},"value":{"$ref":"#/$defs/__schema0"}},"required":["op","path","value"],"additionalProperties":false}]}},"side":{"type":"string","enum":["request","response"]},"fromVersion":{"type":"string","minLength":1,"maxLength":40},"toVersion":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"anyOf":[{"type":"string","maxLength":20000},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"maxItems":200,"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string","maxLength":120},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"example":{"schema":{"type":"object","properties":{"id":{"type":"string"},"total":{"type":"number"}},"required":["id","total"],"additionalProperties":false},"payload":{"id":1,"note":"extra"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"codeExecuted":{"type":"boolean"},"externalCall":{"type":"boolean"},"valuesInvented":{"type":"boolean"},"schemaCompliance":{"type":"boolean"},"status":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"path":{"type":"string"},"keyword":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T15:00:00.000Z","codeExecuted":false,"externalCall":false,"valuesInvented":false,"schemaCompliance":false,"status":"invalid","issues":[{"kind":"missing","code":"required_missing","path":"/total","keyword":"required","detail":"This required property is absent. No value was invented."},{"kind":"conflict","code":"type_mismatch","path":"/id","keyword":"type","detail":"The value is number. The schema allows string."},{"kind":"conflict","code":"additional_property","path":"/note","keyword":"additionalProperties","detail":"This property is not in the schema. It was not removed."}],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/integration/response-normalize":{"post":{"operationId":"normalize_an_api_response","summary":"Normalize an API response","description":"Trim string edges and sort object keys. Types are not changed, fields are not removed, and each change is listed.","tags":["integration"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"$ref":"#/$defs/__schema0"},"example":{"$ref":"#/$defs/__schema0"},"examples":{"maxItems":20,"type":"array","items":{"$ref":"#/$defs/__schema0"}},"schema":{"$ref":"#/$defs/__schema0"},"source":{"$ref":"#/$defs/__schema0"},"target":{"$ref":"#/$defs/__schema0"},"before":{"$ref":"#/$defs/__schema0"},"after":{"$ref":"#/$defs/__schema0"},"json":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"operations":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"rename"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"copy"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"pick"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"omit"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["string","number","integer","boolean"]}},"required":["op","path","type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","minLength":1,"maxLength":200},"value":{"$ref":"#/$defs/__schema0"}},"required":["op","path","value"],"additionalProperties":false}]}},"side":{"type":"string","enum":["request","response"]},"fromVersion":{"type":"string","minLength":1,"maxLength":40},"toVersion":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"anyOf":[{"type":"string","maxLength":20000},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"maxItems":200,"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string","maxLength":120},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"example":{"payload":{"b":" x ","a":1}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"codeExecuted":{"type":"boolean"},"externalCall":{"type":"boolean"},"valuesInvented":{"type":"boolean"},"schemaCompliance":{"type":"boolean"},"status":{"type":"string"},"result":{"type":"object","properties":{"a":{"type":"number"},"b":{"type":"string"}},"additionalProperties":true},"changedCount":{"type":"number"},"changes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"rule":{"type":"string"},"original":{"type":"string"},"normalized":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T15:00:00.000Z","codeExecuted":false,"externalCall":false,"valuesInvented":false,"schemaCompliance":false,"status":"normalized","result":{"a":1,"b":"x"},"changedCount":2,"changes":[{"path":"/","rule":"sort_keys","original":"b,a","normalized":"a,b"},{"path":"/b","rule":"trim","original":"\" x \"","normalized":"\"x\""}],"issues":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/integration/payload-transform":{"post":{"operationId":"transform_a_payload","summary":"Transform a payload","description":"Apply rename, copy, pick, omit, cast, and default in order. A missing source is reported and not invented. A default is written only when the path is absent.","tags":["integration"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"$ref":"#/$defs/__schema0"},"example":{"$ref":"#/$defs/__schema0"},"examples":{"maxItems":20,"type":"array","items":{"$ref":"#/$defs/__schema0"}},"schema":{"$ref":"#/$defs/__schema0"},"source":{"$ref":"#/$defs/__schema0"},"target":{"$ref":"#/$defs/__schema0"},"before":{"$ref":"#/$defs/__schema0"},"after":{"$ref":"#/$defs/__schema0"},"json":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"operations":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"rename"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"copy"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"pick"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"omit"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["string","number","integer","boolean"]}},"required":["op","path","type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","minLength":1,"maxLength":200},"value":{"$ref":"#/$defs/__schema0"}},"required":["op","path","value"],"additionalProperties":false}]}},"side":{"type":"string","enum":["request","response"]},"fromVersion":{"type":"string","minLength":1,"maxLength":40},"toVersion":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"anyOf":[{"type":"string","maxLength":20000},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"maxItems":200,"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string","maxLength":120},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"example":{"payload":{"orderId":"ord_1","email":"Ada@example.com"},"operations":[{"op":"rename","from":"orderId","to":"id"},{"op":"default","path":"status","value":"open"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"codeExecuted":{"type":"boolean"},"externalCall":{"type":"boolean"},"valuesInvented":{"type":"boolean"},"schemaCompliance":{"type":"boolean"},"status":{"type":"string"},"result":{"type":"object","properties":{"email":{"type":"string"},"id":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"changedCount":{"type":"number"},"changes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"rule":{"type":"string"},"original":{"type":"string"},"normalized":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T15:00:00.000Z","codeExecuted":false,"externalCall":false,"valuesInvented":false,"schemaCompliance":false,"status":"transformed","result":{"email":"Ada@example.com","id":"ord_1","status":"open"},"changedCount":2,"changes":[{"path":"/id","rule":"rename","original":"","normalized":"\"ord_1\""},{"path":"/status","rule":"default","original":"","normalized":"\"open\""}],"issues":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/integration/field-map-generate":{"post":{"operationId":"generate_a_field_map","summary":"Generate a field map","description":"Map a path that exists on both sides, or a field name that matches one leaf on each side after splitting camel case and snake case. No value is copied.","tags":["integration"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"$ref":"#/$defs/__schema0"},"example":{"$ref":"#/$defs/__schema0"},"examples":{"maxItems":20,"type":"array","items":{"$ref":"#/$defs/__schema0"}},"schema":{"$ref":"#/$defs/__schema0"},"source":{"$ref":"#/$defs/__schema0"},"target":{"$ref":"#/$defs/__schema0"},"before":{"$ref":"#/$defs/__schema0"},"after":{"$ref":"#/$defs/__schema0"},"json":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"operations":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"rename"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"copy"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"pick"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"omit"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["string","number","integer","boolean"]}},"required":["op","path","type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","minLength":1,"maxLength":200},"value":{"$ref":"#/$defs/__schema0"}},"required":["op","path","value"],"additionalProperties":false}]}},"side":{"type":"string","enum":["request","response"]},"fromVersion":{"type":"string","minLength":1,"maxLength":40},"toVersion":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"anyOf":[{"type":"string","maxLength":20000},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"maxItems":200,"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string","maxLength":120},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"example":{"source":{"orderId":"ord_1","customer":{"emailAddress":"ada@example.com"}},"target":{"order_id":"x","customer":{"email_address":"y"},"note":"n"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"codeExecuted":{"type":"boolean"},"externalCall":{"type":"boolean"},"valuesInvented":{"type":"boolean"},"schemaCompliance":{"type":"boolean"},"status":{"type":"string"},"valuesCopied":{"type":"boolean"},"mappings":{"type":"array","items":{"type":"object","properties":{"sourcePath":{"type":"string"},"targetPath":{"type":"string"},"match":{"type":"string"},"sourceType":{"type":"string"},"targetType":{"type":"string"},"compatible":{"type":"boolean"}},"additionalProperties":true}},"unmappedSource":{"type":"array","items":{}},"unmappedTarget":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"type":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T15:00:00.000Z","codeExecuted":false,"externalCall":false,"valuesInvented":false,"schemaCompliance":false,"status":"mapped","valuesCopied":false,"mappings":[{"sourcePath":"/","targetPath":"/","match":"path","sourceType":"object","targetType":"object","compatible":true},{"sourcePath":"/customer","targetPath":"/customer","match":"path","sourceType":"object","targetType":"object","compatible":true},{"sourcePath":"/orderId","targetPath":"/order_id","match":"name","sourceType":"string","targetType":"string","compatible":true},{"sourcePath":"/customer/emailAddress","targetPath":"/customer/email_address","match":"name","sourceType":"string","targetType":"string","compatible":true}],"unmappedSource":[],"unmappedTarget":[{"path":"/note","type":"string"}],"issues":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/integration/contract-compare":{"post":{"operationId":"compare_api_contracts","summary":"Compare API contracts","description":"List schema changes. A change is labeled breaking or non-breaking only when side is request or response. Title and description are ignored.","tags":["integration"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"$ref":"#/$defs/__schema0"},"example":{"$ref":"#/$defs/__schema0"},"examples":{"maxItems":20,"type":"array","items":{"$ref":"#/$defs/__schema0"}},"schema":{"$ref":"#/$defs/__schema0"},"source":{"$ref":"#/$defs/__schema0"},"target":{"$ref":"#/$defs/__schema0"},"before":{"$ref":"#/$defs/__schema0"},"after":{"$ref":"#/$defs/__schema0"},"json":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"operations":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"rename"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"copy"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"pick"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"omit"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["string","number","integer","boolean"]}},"required":["op","path","type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","minLength":1,"maxLength":200},"value":{"$ref":"#/$defs/__schema0"}},"required":["op","path","value"],"additionalProperties":false}]}},"side":{"type":"string","enum":["request","response"]},"fromVersion":{"type":"string","minLength":1,"maxLength":40},"toVersion":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"anyOf":[{"type":"string","maxLength":20000},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"maxItems":200,"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string","maxLength":120},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"example":{"side":"response","before":{"type":"object","properties":{"id":{"type":"string"},"total":{"type":"number"}},"required":["id"],"additionalProperties":true},"after":{"type":"object","properties":{"id":{"type":"string"},"total":{"type":"integer"}},"required":["id","total"],"additionalProperties":true}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"codeExecuted":{"type":"boolean"},"externalCall":{"type":"boolean"},"valuesInvented":{"type":"boolean"},"schemaCompliance":{"type":"boolean"},"status":{"type":"string"},"side":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"code":{"type":"string"},"effect":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T15:00:00.000Z","codeExecuted":false,"externalCall":false,"valuesInvented":false,"schemaCompliance":false,"status":"compared","side":"response","changes":[{"path":"/total","code":"required_added","effect":"breaking","before":"","after":"total","detail":"This property is newly required."},{"path":"/total","code":"type_changed","effect":"breaking","before":"number","after":"integer","detail":"The type allows fewer values."}],"issues":[],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/integration/version-compatibility-check":{"post":{"operationId":"check_version_compatibility","summary":"Check version compatibility","description":"Order dotted numeric versions and compare the supplied schemas. A version number alone is not treated as compatible. The payload is checked against the later schema.","tags":["integration"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"$ref":"#/$defs/__schema0"},"example":{"$ref":"#/$defs/__schema0"},"examples":{"maxItems":20,"type":"array","items":{"$ref":"#/$defs/__schema0"}},"schema":{"$ref":"#/$defs/__schema0"},"source":{"$ref":"#/$defs/__schema0"},"target":{"$ref":"#/$defs/__schema0"},"before":{"$ref":"#/$defs/__schema0"},"after":{"$ref":"#/$defs/__schema0"},"json":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"operations":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"rename"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"copy"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"pick"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"omit"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["string","number","integer","boolean"]}},"required":["op","path","type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","minLength":1,"maxLength":200},"value":{"$ref":"#/$defs/__schema0"}},"required":["op","path","value"],"additionalProperties":false}]}},"side":{"type":"string","enum":["request","response"]},"fromVersion":{"type":"string","minLength":1,"maxLength":40},"toVersion":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"anyOf":[{"type":"string","maxLength":20000},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"maxItems":200,"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string","maxLength":120},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"example":{"side":"response","fromVersion":"1.2.0","toVersion":"1.3.0","before":{"type":"object","properties":{"id":{"type":"string"},"total":{"type":"number"}},"required":["id"],"additionalProperties":true},"after":{"type":"object","properties":{"id":{"type":"string"},"total":{"type":"integer"}},"required":["id","total"],"additionalProperties":true},"payload":{"id":"ord_1","total":12.5}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"codeExecuted":{"type":"boolean"},"externalCall":{"type":"boolean"},"valuesInvented":{"type":"boolean"},"schemaCompliance":{"type":"boolean"},"status":{"type":"string"},"fromVersion":{"type":"string"},"toVersion":{"type":"string"},"order":{"type":"string"},"compatible":{"type":"boolean"},"payloadStatus":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"code":{"type":"string"},"effect":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"path":{"type":"string"},"keyword":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T15:00:00.000Z","codeExecuted":false,"externalCall":false,"valuesInvented":false,"schemaCompliance":false,"status":"incompatible","fromVersion":"1.2.0","toVersion":"1.3.0","order":"newer","compatible":false,"payloadStatus":"invalid","changes":[{"path":"/total","code":"required_added","effect":"breaking","before":"","after":"total","detail":"This property is newly required."},{"path":"/total","code":"type_changed","effect":"breaking","before":"number","after":"integer","detail":"The type allows fewer values."}],"issues":[{"kind":"conflict","code":"type_mismatch","path":"/total","keyword":"type","detail":"The value is number. The schema allows integer."}],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/integration/diagnose":{"post":{"operationId":"diagnose_an_integration","summary":"Diagnose an integration","description":"Generate a schema from examples, validate the payload, map fields that exist, compare contracts, and apply documented transforms. No external API is called.","tags":["integration"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"$ref":"#/$defs/__schema0"},"example":{"$ref":"#/$defs/__schema0"},"examples":{"maxItems":20,"type":"array","items":{"$ref":"#/$defs/__schema0"}},"schema":{"$ref":"#/$defs/__schema0"},"source":{"$ref":"#/$defs/__schema0"},"target":{"$ref":"#/$defs/__schema0"},"before":{"$ref":"#/$defs/__schema0"},"after":{"$ref":"#/$defs/__schema0"},"json":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"operations":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"rename"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"copy"},"from":{"type":"string","minLength":1,"maxLength":200},"to":{"type":"string","minLength":1,"maxLength":200}},"required":["op","from","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"pick"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"omit"},"paths":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["op","paths"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"cast"},"path":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["string","number","integer","boolean"]}},"required":["op","path","type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"default"},"path":{"type":"string","minLength":1,"maxLength":200},"value":{"$ref":"#/$defs/__schema0"}},"required":["op","path","value"],"additionalProperties":false}]}},"side":{"type":"string","enum":["request","response"]},"fromVersion":{"type":"string","minLength":1,"maxLength":40},"toVersion":{"type":"string","minLength":1,"maxLength":40}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"anyOf":[{"type":"string","maxLength":20000},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"maxItems":200,"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string","maxLength":120},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"example":{"side":"response","fromVersion":"1.2.0","toVersion":"1.3.0","example":{"orderId":"ord_1","total":12},"payload":{"orderId":"ord_1"},"before":{"type":"object","properties":{"orderId":{"type":"string"},"total":{"type":"number"}},"required":["orderId"],"additionalProperties":true},"after":{"type":"object","properties":{"orderId":{"type":"string"},"total":{"type":"integer"}},"required":["orderId","total"],"additionalProperties":true},"source":{"orderId":"ord_1","total":12},"target":{"order_id":"ord_1","total":1},"operations":[{"op":"rename","from":"orderId","to":"id"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"codeExecuted":{"type":"boolean"},"externalCall":{"type":"boolean"},"valuesInvented":{"type":"boolean"},"schemaCompliance":{"type":"boolean"},"status":{"type":"string"},"schemaGenerated":{"type":"boolean"},"schema":{"type":"object","properties":{"type":{"type":"string"},"properties":{"type":"object","properties":{"orderId":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true},"total":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"required":{"type":"array","items":{"type":"string"}},"additionalProperties":{"type":"boolean"}},"additionalProperties":true},"validationStatus":{"type":"string"},"order":{"type":"string"},"compatible":{"type":"boolean"},"valuesCopied":{"type":"boolean"},"transformed":{"type":"boolean"},"mappings":{"type":"array","items":{"type":"object","properties":{"sourcePath":{"type":"string"},"targetPath":{"type":"string"},"match":{"type":"string"},"sourceType":{"type":"string"},"targetType":{"type":"string"},"compatible":{"type":"boolean"}},"additionalProperties":true}},"contractChanges":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"code":{"type":"string"},"effect":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"result":{"type":"object","properties":{"id":{"type":"string"}},"additionalProperties":true},"changes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"rule":{"type":"string"},"original":{"type":"string"},"normalized":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"path":{"type":"string"},"keyword":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T15:00:00.000Z","codeExecuted":false,"externalCall":false,"valuesInvented":false,"schemaCompliance":false,"status":"diagnosed","schemaGenerated":true,"schema":{"type":"object","properties":{"orderId":{"type":"string"},"total":{"type":"integer"}},"required":["orderId","total"],"additionalProperties":true},"validationStatus":"invalid","order":"newer","compatible":false,"valuesCopied":false,"transformed":true,"mappings":[{"sourcePath":"/","targetPath":"/","match":"path","sourceType":"object","targetType":"object","compatible":true},{"sourcePath":"/total","targetPath":"/total","match":"path","sourceType":"integer","targetType":"integer","compatible":true},{"sourcePath":"/orderId","targetPath":"/order_id","match":"name","sourceType":"string","targetType":"string","compatible":true}],"contractChanges":[{"path":"/total","code":"required_added","effect":"breaking","before":"","after":"total","detail":"This property is newly required."},{"path":"/total","code":"type_changed","effect":"breaking","before":"number","after":"integer","detail":"The type allows fewer values."}],"result":{"id":"ord_1"},"changes":[{"path":"/id","rule":"rename","original":"","normalized":"\"ord_1\""}],"issues":[{"kind":"missing","code":"required_missing","path":"/total","keyword":"required","detail":"This required property is absent. No value was invented."}],"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.12"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}