Skip to main content

Create an experiment

POST 
/api/v1/experiments

Starts an experiment asynchronously and returns a W&B run id to poll.

The request model accepts ~105 fields, nearly all of them internal tuning knobs with defaults. In practice a useful experiment needs only the research question; the fields below are the supported minimal contract, mirroring MCPExperimentRequest in the MCP server.

Accepted is not the same as queued. A 200 response with a run id does not guarantee the run was enqueued. If no W&B run appears within roughly 25 minutes, resubmit. See the run status endpoint for how to verify.

Request​

Responses​

Successful Response