Skip to main content
A destination delivers data from completed runs to storage you own or a data platform you use. Destinations belong to your workspace and can deliver all of its workflows or a selected set. Kadoa configures every destination for you through the Support Center.

When Kadoa delivers

Kadoa delivers data to Amazon S3, Google Cloud Storage, and SFTP immediately after a workflow run completes. Data is available in Snowflake and Databricks about 5 minutes after completion.

Formats

Amazon S3, Google Cloud Storage, and SFTP support these file formats.

File layout and path template

The default path template is:
If you set a prefix, Kadoa adds it before this path. For each run, Kadoa writes one file for each selected format. With the default template, each run has a unique path. This prevents overwrites of files from other runs.

Additional fields

Additional fields add source labels or workflow details to every exported record. They are available in CSV, JSONL, and JSON files, but not Parquet. Each field has a name you choose and a fixed value or a variable. Kadoa replaces variables with the details of the workflow or run. Supported variables:
  • {teamId}
  • {workflowId}
  • {workflowName}
  • {runId}
  • {runDate}
  • {runDatetime}

Workflow health files

Health files let you monitor workflow status from your Amazon S3, Google Cloud Storage, or SFTP destination. They are enabled by default for Amazon S3 and Google Cloud Storage, and disabled for SFTP. Kadoa can enable or disable health files for your destination. When enabled, Kadoa writes one JSON file for each of these events:
  • workflow_finished: a scheduled workflow finishes.
  • workflow_failed: a scheduled or realtime workflow fails.
  • workflow_recovered: a realtime workflow recovers.
File path:
runId is present only when the event belongs to a run.

View your destinations

See which destinations deliver a workflow’s results without contacting support:
  • In the dashboard: the Deliver section of the Pipeline panel lists connected destinations first, or open the workflow’s Download dropdown.
  • Via the API: List workflow destinations returns each destination’s name, provider, target (bucket URI, SFTP host, or warehouse share), and file formats.
Only deliverable destinations are listed (enabled, verified, not revoked).

Request, change, or disable a destination

To request a new destination for a workflow, open the workflow’s Pipeline panel, choose Deliver, click Add under Destinations, and click Set up next to the destination. The Support Center request opens prefilled with the workflow and the details we need; fill them in and submit. For a change or to disable a destination, submit a Support Center request that names the destination, what you want to change, and the new value.

Glossary

Destination: The configuration that sends completed-run data to your storage or data platform. Delivery: One transfer or publication for one run. Run: One execution of a workflow. Workflow: The configured process that collects and structures your data. Team: The Kadoa workspace that owns workflows and destinations.