Under the Hood·Architecture Deep Dive

How Blacksmith Forges Code

A real-time safety layer engineered for n8n and Make. When schemas fracture and data flows halt, our AI Anvil catches the impact, hammers the JSON into perfection, and quenches your pipeline back into production.

The 4-Stage Recovery Pipeline

Average End-to-End Latency: 840ms

01Stage 1: Interception

The Catch & Trap

Edge Webhook Ingress (<35ms)

When a node in n8n or Make throws an unhandled exception or receives an unexpected 4xx/5xx response, your Error Handler routes the complete execution envelope (Headers, Query, Faulty Body, Compiler Error) directly to Blacksmith.

AutonomousReady ✓

02Stage 2: Diagnosis

The Furnace Heat

Schema Differential Parser

The payload enters our diagnostic furnace. We cross-reference the incoming JSON keys against the target API's schema specifications, pinpointing renamed keys, mutated data types, dropped required fields, and JSON syntax errors.

AutonomousReady ✓

03Stage 3: AI Anvil

The Anvil Strike

Fine-Tuned Schema LLM

The AI Anvil strikes the damaged payload. Strings containing formatted currencies are coerced into pure floats, renamed parameters (e.g. amount_total → amount) are mapped, and nested structures are forged to meet exact destination constraints.

AutonomousReady ✓

04Stage 4: Resumption

The Quench & Resume

Automated Resume Relay (<200ms)

The tempered, verified payload is transmitted back to your automation's resume webhook or retry node. The execution carries forward from the exact node that failed, preserving downstream state and eliminating manual intervention.

AutonomousReady ✓

Interactive Anvil Simulator

Choose a damaged scenario and trigger the hammer to witness live JSON schema reconstruction.

Damaged Input PayloadRejected by API

SchemaError: 'amount_subtotal' provided where 'amount' expected

{
  "event": "invoice.payment_succeeded",
  "customer_id": "cus_J91bX9",
  "amount_subtotal": "8950",
  "tax_exempt": "none",
  "legacy_ref": null
}

Forged Anvil Output100% Validated

Renamed 'amount_subtotal' to 'amount' & parsed string '8950' to integer 8950.

{
  "event": "invoice.payment_succeeded",
  "customer_id": "cus_J91bX9",
  "amount": 8950,
  "tax_exempt": "none",
  "_blacksmith": {
    "coerced_keys": [
      "amount_subtotal -> amount"
    ],
    "numeric_cast": true
  }
}

Setup Walkthrough

Connect n8n or Make in 60 Seconds

Zero code changes to your workflow nodes. Simply plug our webhook into your error handler.

STEP 1

Add Error Trigger Node

Inside your n8n workflow canvas, add an "Error Trigger" node. This node catches any execution error across your pipeline.

STEP 2

Paste Catch Webhook

Connect an HTTP Request node to your Blacksmith Catch URL with Method = POST and Body = All Execution JSON.

STEP 3

Resume Automatically

Blacksmith repairs the payload and posts to your workflow's resume webhook. Your flow finishes cleanly.

Your Catch Endpoint Sample

https://forge.blacksmith.ai/v1/catch/demo_key

Open Forge Control