POST
/
mapping

This is a workflow endpoint, which is an abstraction over multiple base endpoints. This endpoint allows an end to end mapping generation workflow to be executed from scratch. This endpoint does the following in one call:

  1. Create Pipeline: creates a pipeline given a name, description, and target schema.
  2. Create Job: creates a job given source data.
  3. Run job: executes job run.
  4. Get Result: returns the output result object.

Note: Input data is not required if a joined_data_id is provided, which comes from the Joined Data endpoint. This instead pulls the joined data and uses it as the input.

Authorizations

lume-api-key
string
headerrequired

Body

application/json

Represents a mapping flow create request.

This class provides the schema for creating a mapping flow.

name
string
required

The name of the pipeline. Must be unique within the organization.

target_schema
required

The target schema to associate with the pipeline

data
object[] | null

The data to be processed

joined_data_id
string | null

The ID of the joined data to be processed

description
string | null

The description of the pipeline

global_context
string | null

The global context of the pipeline

from_sheet
boolean
default: false

The name of the sheet to read from in the source file

sheet_id
string | null

The name of the sheet to read from in the source file

Response

200 - application/json

Represents a mapping result.

This class provides the schema for a mapping result.

id
string
required
status
string
required
created_at
string
required
pipeline_id
string
required

The pipeline ID

cleaning
boolean
default: false

Whether the result is a cleaning result

info
object[]

The metadata of the result

updated_at
string | null
job_id
string | null

The job ID

mapped_data
object[] | null

The mapped data

warning
object[] | null

The warning message