Skip to main content

​
Overview

Every pipeline can be exported from the dashboard as a YAML definition document and reimported to overwrite its configuration. The exported document uses the same schema as the public API, so the same file works for both flows. Use this to:
  • Snapshot a pipeline before making large changes.
  • Copy a pipeline configuration between environments.
  • Review configuration changes in version control.

​
Export a pipeline

1
Open the pipeline’s detail page and go to the Settings tab.
2
In the Pipeline definition section, click Export.
3
A YAML file is downloaded with the pipeline’s current configuration. Sensitive fields (credentials, internal state, region routing) are omitted.

​
Import a pipeline definition

Importing overwrites the pipeline’s configuration to match the uploaded document.

​
Prerequisites

The pipeline must be stopped. Active or transitioning pipelines (status RUNNING, STARTING, or PAUSING) cannot be imported into. The Import button is disabled with a tooltip explaining why.
1
Stop the pipeline if it is currently running.
2
On the Settings tab, click Import in the Pipeline definition section.
3
Upload a YAML or JSON file with Choose file, or paste the document into the editor.
4
Click Import. The dashboard validates the document and applies the change. Validation errors are listed inline.

​
Definition format

The dashboard accepts the same documents as the public API. See Public API: Pipeline definition document for the full schema, supported transformation types, and examples.

​
See also

  • Public API for the programmatic equivalent.
  • Hooks for the notification hooks referenced inside a definition.
Last modified on June 15, 2026