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

Generates a field mapping between two JSON schemas or payloads, identifying compatible paths, name matches, type compatibility, and unmapped fields.

## Facts

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

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

Example prompt: I have a source JSON schema with fields like orderId and customer.emailAddress, and a target schema that uses order_id and customer.email_address — can you generate a field map between them so I know which fields match, which need renaming, and which are unmapped?

## When to prefer this

Use this endpoint when you need to automatically generate a field mapping between two JSON schemas or payloads without writing custom code. It is especially useful for API migration tasks, third-party integration setup, or detecting breaking changes between schema versions. It operates without executing user code or making external calls, making it safe and deterministic. Prefer it over manual mapping when schemas are complex or when you need a structured, machine-readable mapping output with explicit unmapped fields and type compatibility signals.

## Known failure modes

- Invalid or malformed JSON schema causes parsing error
- Base64-encoded file exceeds size limit (12MB)
- Unsupported media type for file upload
- Too many examples provided (max 20)
- Field path string exceeds 200 character limit
- Ambiguous schema structure prevents confident mapping
- x402 payment not completed — 402 response returned

## 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 list of field mappings with match type (path or name), source and target paths, type compatibility, unmapped source fields, unmapped target fields, a status (e.g. 'mapped'), any issues found, and a list of limitations applied during analysis. Also includes flags for whether code was executed, external calls were made, or values were invented.

## 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": {
  "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-9635535a/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)
