tofupilot imports

Last updated on June 16, 2026

The imports command creates Runs from existing files, covering both structured report formats and tabular files like CSV. See Import for the supported formats.

structured

The structured subcommand imports runs from structured files. The required flag is --items (JSON), a list of 1 to 100 files where each item is parsed independently, so one failure does not abort the others. Each item carries an upload_id (from the two-step upload) and an importer naming the source format (OPENHTF, WATS, WSXF, ATML, TESTSTAND, STDF, or ATDF).

import structured files
tofupilot imports structured --items '[{"upload_id":"upload_abc","importer":"OPENHTF"}]'

tabular

The tabular subcommand imports a run from a tabular file. Required flags are --upload-id (a previously uploaded file) and --procedure-id (always overrides any procedure referenced in the file). Pass either --mapping (inline JSON column mapping) or --template-id (a saved mapping template), not both.

import tabular file
tofupilot imports tabular --upload-id upload_abc --procedure-id proc_abc --template-id tpl_abc

How is this guide?

On this page