Skip to main content
POST
/
api
/
suites
/
{id}
/
run
Python
import requests

url = "https://app.langwatch.ai/api/suites/{id}/run"

payload = { "idempotencyKey": "<string>" }
headers = {
    "X-Auth-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "scheduled": true,
  "batchRunId": "<string>",
  "setId": "<string>",
  "jobCount": 123,
  "skippedArchived": {
    "scenarios": [
      "<string>"
    ],
    "targets": [
      "<string>"
    ]
  },
  "items": [
    {
      "scenarioRunId": "<string>",
      "scenarioId": "<string>",
      "target": {
        "referenceId": "<string>"
      },
      "name": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.

Path Parameters

id
string
required

Body

application/json
idempotencyKey
string

Response

Suite run scheduled

scheduled
boolean
required
batchRunId
string
required
setId
string
required
jobCount
number
required
skippedArchived
object
required
items
object[]
required