# BRAINIAC Field Map Generate

> BRAINIAC Field Map Generate is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-16).

Generates a field mapping between two JSON schemas or data structures, identifying compatible paths, type mismatches, and proposed field transformations.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/api-integration/field-map-generate?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-field-map-generate-bde7d607
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IojskxPIx210c2FECInko

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-field-map-generate-bde7d607 -d '<json body>'
```

Example prompt: Can you generate a field map between my source JSON schema (the old API response with camelCase fields) and my target schema (the new API request with snake_case fields) on the response side, and tell me which fields are unmapped or incompatible?

## When to prefer this

Choose this endpoint when you need to programmatically generate a field mapping between two JSON schemas or payloads without writing custom code — especially useful during API migrations, third-party integrations, or when aligning request/response schemas across versions. It is well-suited for agents that need to reason about data structure compatibility without executing external code or calling other APIs. Prefer this over manual diffing or generic LLM schema comparison when you need a structured, machine-readable mapping output with explicit unmapped fields and transformation suggestions.

## Known failure modes

- Oversized payload exceeding the 200,000 character JSON limit returns a validation error
- Invalid or malformed base64 file content causes a parse failure
- Unsupported media type (not application/json or text/plain) returns a schema error
- Ambiguous or sparse examples may result in incomplete generated schemas with additionalProperties:true
- Field mappings are only proposed when path or name matches — highly divergent schemas may return many unmapped fields
- Unsupported JSON Schema keywords are reported but not applied, potentially causing incomplete validation

## 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 a 'status' (e.g. 'mapped'), an array of 'mappings' each containing sourcePath, targetPath, match type (path or name), and compatibility flag, arrays of 'unmappedSource' and 'unmappedTarget' fields, a list of 'issues', a 'limitations' array explaining what the engine did and did not check, and boolean flags for codeExecuted, externalCall, valuesInvented, valuesCopied, and schemaCompliance.

## 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": {
  "issues": [],
  "status": "mapped",
  "mappings": [
   {
    "match": "path",
    "compatible": true,
    "sourcePath": "/",
    "sourceType": "object",
    "targetPath": "/",
    "targetType": "object"
   },
   {
    "match": "path",
    "compatible": true,
    "sourcePath": "/customer",
    "sourceType": "object",
    "targetPath": "/customer",
    "targetType": "object"
   },
   {
    "match": "name",
    "compatible": true,
    "sourcePath": "/orderId",
    "sourceType": "string",
    "targetPath": "/order_id",
    "targetType": "string"
   },
   {
    "match": "name",
    "compatible": true,
    "sourcePath": "/customer/emailAddress",
    "sourceType": "string",
    "targetPath": "/customer/email_address",
    "targetType": "string"
   }
  ],
  "checkedAt": "2026-11-03T15:00:00.000Z",
  "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,
  "valuesCopied": false,
  "unmappedSource": [],
  "unmappedTarget": [
   {
    "path": "/note",
    "type": "string"
   }
  ],
  "valuesInvented": false,
  "schemaCompliance": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-field-map-generate-bde7d607/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)
