Skip to content
Go to Boltz API
Predictions
Structure And Binding

Run

Custom CLI workflow command for `boltz-api predictions:structure-and-binding run`.

Start a prediction, wait for completion, and download results

This is CLI workflow behavior, not a standalone REST endpoint. It composes generated API commands from this resource to submit work, wait for completion, and persist local results.

Terminal window
boltz-api predictions:structure-and-binding run
OptionDescription
--input [ --input ]Structure and binding prediction input. Pass inline JSON/YAML, or use @json://... / @yaml://... for larger payload files. Include entities plus optional constraints, bonds, templates, binding settings, sample count, and model options. Keep --model, --idempotency-key, and --workspace-id as top-level flags.
--model stringModel to use for prediction
--idempotency-key stringClient-provided key to prevent duplicate submissions on retries
--workspace-id stringTarget workspace ID (admin keys only; ignored for workspace keys)
--name stringLocal run directory name under --root-dir
--run-dir stringExplicit local run directory path
--root-dir stringRoot directory for generated local run directories (default: "boltz-experiments")
--poll-interval-seconds floatPolling interval while waiting for remote results (default: 5)
--progress-format jsonlFormat for progress logs written to stderr (jsonl or text). jsonl is the default agent-friendly format. (default: "jsonl")
--verbose, -vPrint text progress logs to stderr when --progress-format text is selected (default: false)
--help, -hshow help