Skip to main content
The verial benchmarks commands manage Benchmarks — ordered groups of tasks that reference an environment and are evaluated against criteria. Use them to script benchmark definitions alongside your agent code. Authentication is required. See verial auth.

Subcommands

CommandDescription
verial benchmarks listList benchmarks in your organization.
verial benchmarks createCreate a new benchmark.
verial benchmarks getGet a single benchmark by ID.
verial benchmarks updateUpdate benchmark metadata or run limits.
verial benchmarks deleteDelete a benchmark.

verial benchmarks list

List benchmarks visible to your organization. Synopsis:
verial benchmarks list
Example:
verial benchmarks list
ID                  NAME                        CREATED
bench_cly987        Prior Auth Workflow         4/1/2026, 1:15:42 PM
bench_cly988        Appointment Scheduling      4/3/2026, 10:08:19 AM
REST equivalent: GET /benchmarks.

verial benchmarks create

Create a benchmark. Tasks and criteria are attached through the REST API or dashboard after creation. Synopsis:
verial benchmarks create --name <name> \
  [--description <desc>] \
  [--timeout <seconds>] \
  [--concurrency <n>]
Options:
FlagDescriptionDefault
--name <name>Benchmark name.Required
--description <desc>Free-text description.
--timeout <seconds>Per-task timeout in seconds.300
--concurrency <n>Max tasks to run in parallel during a run.1
Example:
verial benchmarks create \
  --name "Prior Auth Workflow" \
  --description "End-to-end PA submission across fax + payer portal" \
  --timeout 600 \
  --concurrency 4
REST equivalent: POST /benchmarks.

verial benchmarks get

Fetch a single benchmark, including tasks and criteria. Synopsis:
verial benchmarks get --id <id>
Example:
verial benchmarks get --id bench_cly987
REST equivalent: GET /benchmarks/:id.

verial benchmarks update

Update benchmark metadata or run limits. Omitted fields are left unchanged. Synopsis:
verial benchmarks update --id <id> \
  [--name <name>] \
  [--description <desc>] \
  [--timeout <seconds>] \
  [--concurrency <n>]
Example:
verial benchmarks update --id bench_cly987 --concurrency 8
REST equivalent: PATCH /benchmarks/:id.

verial benchmarks delete

Delete a benchmark. Previously completed runs are retained. Synopsis:
verial benchmarks delete --id <id>
Deleted bench_cly987
REST equivalent: DELETE /benchmarks/:id.

Next Steps

Benchmarks

Benchmark model, tasks, and criteria.

Benchmarks API

Full REST parameters and response schema.