Skip to main content
GET
Python

Authorizations

X-Auth-Token
string
header
required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Query Parameters

includeArchived
string
default:false

Include archived run plans in the list. true, 1, yes for yes; false, 0, no or omitted for no.

Response

200 - application/json

Success

id
string
required

The run plan id.

name
string
required

The run plan name. This is the plan's identity: a run started under this name joins this plan.

slug
string
required

The plan's address in the platform. It is kept when the plan is renamed, so run history never moves.

scope
object
required

What the run plan covers: all (every active scenario), folders (the scenarios filed in the named test suites), labels (the scenarios carrying any of the labels), or cases (the scenarioIds sent with the configuration). A dynamic scope is resolved again at every run, so a scenario written later runs without editing the plan.

scenarioIds
string[]
required

The scenarios the last run of this plan covered.

targets
object[]
required

What the plan runs against, in the order the results show.

repeatCount
number
required

How many times each scenario and target pairing runs.

simulatorModel
string | null
required

The model that plays the user, or null for the scenario or project default.

judgeModel
string | null
required

The model that judges the run, or null for the scenario or project default.

labels
string[]
required

The labels the plan carries.

archivedAt
string | null
required

When the plan was archived, or null while it is active.

createdAt
string
required

When the plan was created.

updatedAt
string
required

When the plan was last written.

platformUrl
string<uri>
required

Where to open this run plan in the LangWatch platform.

Last modified on August 28, 2026