start_run
Collect answers now for the selected prompts and models. The tool reserves the credits shown in the preview, so it needs a confirmation token on every execution.Parameters
Before you start
- Call
estimate_runto see the usable prompts, models and the estimated credits. - Call
get_creditsif you need to check that the balance covers the cost. - Call
start_runwithout a token to receive the preview and the token, then repeat the call with the token.
After the run starts
Collection is asynchronous. Follow progress withget_run and list_runs. There is no MCP tool to cancel or retry a run. To be notified by your own systems when a run finishes, subscribe to the run.completed event with the REST API.
The preview shows the credits that would be reserved. Moving credits between teams and buying more remain dashboard actions.
Example
Related
- Run and credit tools for estimates, status and the credit balance.
- Onboard a client with the API for a REST workflow that ends with a first run.

