---
title: "Start Run"
method: POST
path: "/product_flow_e2e/runs"
---

# Start Run

`POST /product_flow_e2e/runs`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/product_flow_e2e/runs`
- Auth: none declared

Start a product-flow E2E run. Returns immediately with a run_id for polling.

## Request body

- StartProductFlowE2ERunRequest: Request to start a product-flow E2E run. ``test_names`` narrows the run to specific tests (all tests when ``None`` or empty). The run always targets the cluster's own API (resolved on the worker from ``product_flow_e2e.api_base_url`` in app config), so there is no environment override.
  - `test_names` string[], nullable

## Response `200`

Successful Response

- StartProductFlowE2ERunResponse: Response returned immediately after a run is created.
  - `run_id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)