Build a Pipeline

Define extraction, transformations and run frequency.

A pipeline is the contract between your raw data and your dashboards: read this source, apply these steps, on this cadence.

Anatomy of a pipeline

FieldTypeDescription
namestringHuman-readable identifier, unique in the workspace.
descriptionstringWhat the pipeline is for. Shown on the detail page.
data_sourceidThe source whose raw data is read.
transformationsarrayOrdered steps applied to the extracted rows.
frequencyenumhourly, daily, weekly or monthly.
run_timetimeWhen a scheduled run should start, in UTC.
is_enabledbooleanWhen false the scheduler skips this pipeline.

Creating a pipeline

  1. 1

    Open Pipelines

    Go to Pipelines and select Create Pipeline.
  2. 2

    Describe it

    Give it a name and a one-line description. Future-you will thank present-you.
  3. 3

    Select the data source

    Only sources that exist in the current workspace are listed.
  4. 4

    Add transformations

    Add steps in the order they should run. See Transformations for the full reference.
  5. 5

    Set the schedule

    Choose a frequency and run time. You can also leave it manual and trigger runs yourself.
  6. 6

    Save, then run once

    Run it immediately to confirm the output before you rely on the schedule.

Scheduling

Frequency

FieldTypeDescription
hourlystringEvery hour on the hour (UTC).
dailystringOnce per day at run_time.
weeklystringSame weekday and run_time each week.
monthlystringSame day of month and run_time.

Editing and disabling

Editing a pipeline never rewrites history. Existing executions keep the transformations they ran with, and the next run uses the new definition.

Set is_enabled to false to pause a pipeline without deleting it. Scheduled runs stop; manual runs are still allowed.

Best practices

  • One pipeline per dataset — avoid chaining pipelines together.
  • Push transformations as close to the source as possible.
  • Keep a description that states the business question it answers.
  • After changing transformations, run once and check the record count.

Last reviewed October 2026.