Skip to contentSkip to page list

Docs

List suite templates

List the suite templates that ship with LangWatch: archetypes of everyday behaviour tests and red team packs such as the OWASP Top 10 lists. Each carries its full scenario data, so a caller can preview what applying it creates.

GET/api/v1/test-suites/templates
Request and response examples
request.py
import osimport requests​origin = "https://app.langwatch.ai"path = "/api/v1/test-suites/templates"api_key = os.environ["LANGWATCH_API_KEY"]headers = {    "X-Auth-Token": api_key,}​response = requests.get(    origin + path,    headers=headers,)print(response.json())

Success

application/json · Generated from schema

[  {    "id": "string",    "version": 0,    "kind": "archetype",    "title": "string",    "description": "string",    "criteria": [],    "scenarios": [      {        "key": "string",        "name": "string",        "situation": "string",        "criteria": [          "string"        ],        "labels": [],        "attack": {          "attackGoal": "string",          "owaspIds": [            null          ],          "strategy": "crescendo",          "maxTurns": 30        }      }    ]  }]
api-reference/test-suites/list-suite-templates

Authorization

X-Auth-Tokenstringheaderrequired

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.

Responses

200

Success

application/json

object[]
idstringrequired
Up to 80 charactersPattern ^[a-z0-9]+(-[a-z0-9]+)*$
versionintegerrequired
Maximum 9007199254740991
kindstringrequired
One of"archetype""red_team_pack"
titlestringrequired
At least 1 character
descriptionstringrequired
At least 1 character
criteriastring[]required
Default: []
scenariosobject[]required

Documentation