run_feature
Dispatch a test run for a feature. Returns the runId immediately; the sandbox executes in the background (typically ~30 s).
warning
The feature must have status generated — anything else is rejected with 409 conflict.
Request
POST /api/v1/ops/projects/{project}/features/{feature}/run
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
project | path | string | yes | The project's public id. |
feature | path | string | yes | Feature id or name. |
config | body | string | no | Playwright configuration name (default Default — see list_configs). |
siteUrl | body | string | no | Test site URL override. |
- cURL
- CLI
- MCP
curl -X POST -H "Authorization: Bearer $TESTVIBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"config": "Mobile"}' \
"$TESTVIBE_SERVER/api/v1/ops/projects/$PROJECT/features/12/run"
testvibe run "Login Functionality" --config Mobile --wait
Tool run_feature — { "feature": "Login Functionality", "config": "Mobile" }. Follow with wait_for_run.
Response
202 Accepted
{ "runId": 214, "featureId": 12 }
Poll get_run (or use wait_for_run) until status leaves running.
Errors
| HTTP | When |
|---|---|
404 not_found | No such feature in this project. |
409 conflict | Feature not runnable (not generated), or the dispatch was rejected. |