# BRAINIAC Payload Transform API

> BRAINIAC Payload Transform API 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-17).

Transforms, validates, and migrates JSON payloads by applying field rename, copy, pick, omit, cast, and default operations, with schema compliance checking and change tracking.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/api-integration/payload-transform?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-payload-transform-api-c915df22
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_84_-guD-7jwHYsKAGcynl

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-payload-transform-api-c915df22 -d '<json body>'
```

Example prompt: Take this JSON payload {"order_id":"ord_1","user_email":"Ada@example.com"} and rename order_id to id, then validate it against my target schema — tell me what changed and whether it's compliant.

## When to prefer this

Choose this endpoint when you need to programmatically transform, rename, reshape, or validate a JSON payload without executing user-supplied code or calling external APIs — especially for API integration tasks like field mapping between schemas, version migrations, or payload cleanup. Ideal for agents handling API glue logic, data normalization, or schema compliance checks in a sandboxed, auditable way. Prefer over custom code when you need a traceable change log and schema compliance report.

## Known failure modes

- Invalid base64 encoding for file input
- Payload or JSON string exceeds size limits (200KB for JSON string, ~12MB for file)
- Unsupported mediaType for file upload
- More than 20 items in examples array or more than 40 paths in pick/omit
- Malformed operation definition (missing required op fields)
- Ambiguous field mapping when source and target schema have multiple matching fields
- JSON Schema keywords outside supported set (type, properties, required, additionalProperties, items, enum, const, length, range, email/date/date-time formats) are reported but not applied
- Payment failure via x402 if insufficient USDC balance on Base

## 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 transformed JSON result object with the applied changes, a list of change records (each with path, rule, original and normalized values), a count of changed fields, any validation issues, schema compliance status, and noted limitations about what the transform engine does and does not support. Meta-fields confirm no external calls or code execution occurred.

## 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": [],
  "result": {
   "id": "ord_1",
   "email": "Ada@example.com",
   "status": "open"
  },
  "status": "transformed",
  "changes": [
   {
    "path": "/id",
    "rule": "rename",
    "original": "",
    "normalized": "\"ord_1\""
   },
   {
    "path": "/status",
    "rule": "default",
    "original": "",
    "normalized": "\"open\""
   }
  ],
  "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."
  ],
  "changedCount": 2,
  "codeExecuted": false,
  "externalCall": false,
  "valuesInvented": false,
  "schemaCompliance": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-payload-transform-api-c915df22/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)
