AI Parse Transform

Convert natural language transform descriptions into structured pipeline transform nodes using LLM-powered parsing.

POST /api/v1/ai/parse-transform

Parses a natural language description of a data transformation into a structured pipeline transform definition. Automatically loads the tenant’s data schema fields for context.

Request Body

Field	Type	Required	Description
description	string	Yes	Natural language description of the transform (e.g., “hash the email column for PII masking”)
availableFields	string[]	No	List of available field names. If omitted, fields are loaded from the tenant’s data schemas.

Example

curl -X POST https://playground.kaireonai.com/api/v1/ai/parse-transform \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "description": "Rename first_name to firstName and last_name to lastName, then mask the SSN column"
  }'

Response

Returns one or more transform node definitions ready to be added to a pipeline.

{
  "transforms": [
    {
      "type": "rename_field",
      "config": {
        "mappings": [
          { "from": "first_name", "to": "firstName" },
          { "from": "last_name", "to": "lastName" }
        ]
      }
    },
    {
      "type": "mask_pii",
      "config": {
        "field": "ssn",
        "strategy": "hash"
      }
    }
  ]
}

Roles

admin, editor

See also: AI | Pipelines