run_feature

Run a feature's generated Playwright tests in a cloud sandbox.

Dispatch a test run for a feature. Returns the runId immediately; the sandbox executes in the background (typically ~30 s).

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

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"

CLI

testvibe run "Login Functionality" --config Mobile --wait

MCP

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.