QFind anything/

Create a field mapping

Creates or updates a field mapping for a data source.

Parameters

source(string)required

Data source (e.g. stripe, csv).

mappings(object)required

Field mapping rules. Keys are target fields; values are source field paths or transform expressions.

POST/field-mappings

curl -X POST "http://localhost:8000/api/v1/field-mappings" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Tenant-Id: $TENANT_ID" \
  -H "X-Environment: production" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "stripe",
    "mappings": {
      "merchant": "merchant_name",
      "amount": "amount / 100",
      "date": "created",
      "reference": "id",
      "description": "description"
    }
  }'

Response(201)

{
  "id": "089fafeb-bfb2-491a-9fb3-718118e808be",
  "source": "stripe",
  "mappings": {
    "merchant": "merchant_name",
    "amount": "amount / 100"
  },
  "createdAt": "2025-02-01T10:00:00.000Z",
  "updatedAt": "2025-02-01T10:00:00.000Z"
}