Skip to main content
The verial datasets commands manage Datasets — typed data containers (FHIR bundles, file manifests, SFTP drops, HL7 messages) that back simulators. Use them to script dataset lifecycle in CI or before attaching data to an environment. Authentication is required. See verial auth.

​
Subcommands

CommandDescription
verial datasets listList datasets in your organization.
verial datasets createCreate a dataset of a given type.
verial datasets getGet a single dataset by ID.
verial datasets updateUpdate a dataset’s name or description.
verial datasets deleteDelete a dataset.

​
verial datasets list

List datasets visible to your organization. Synopsis: 
verial datasets list
Example: 
verial datasets list

ID                  NAME                     TYPE     CREATED
ds_clxyz001         Primary Care FHIR        FHIR     4/10/2026, 9:02:11 AM
ds_clxyz002         Referral Fax Files       Files    4/12/2026, 11:47:30 AM
REST equivalent: GET /datasets.

​
verial datasets create

Create a typed dataset. The --type value determines how contents are stored and which simulators can consume it. Synopsis: 
verial datasets create --name <name> --type <type> [--description <desc>]
Options:
FlagDescriptionRequired
--name <name>Dataset name.Yes
--type <type>One of FHIR, Files, Sftp, HL7.Yes
--description <desc>Free-text description.No
Example: 
verial datasets create \
  --name "Primary Care FHIR" \
  --type FHIR \
  --description "Seed bundle for primary care scenarios"
REST equivalent: POST /datasets.

​
verial datasets get

Fetch a single dataset, including its config and (where applicable) file manifest. Synopsis: 
verial datasets get --id <id>
Example: 
verial datasets get --id ds_clxyz001
REST equivalent: GET /datasets/:id.

​
verial datasets update

Rename or redescribe a dataset. Contents are mutated through type-specific endpoints, not this command. Synopsis: 
verial datasets update --id <id> [--name <name>] [--description <desc>]
Example: 
verial datasets update --id ds_clxyz001 --name "Primary Care FHIR (v2)"
REST equivalent: PATCH /datasets/:id.

​
verial datasets delete

Delete a dataset. Sandboxes that branched from it retain their child datasets. Synopsis: 
verial datasets delete --id <id>

Deleted ds_clxyz001
REST equivalent: DELETE /datasets/:id.

​
Next Steps

Datasets

Dataset types, config shape, and sandbox branching.

Datasets API

Full REST parameters and response schema.