# 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.

> Page: https://langwatch.ai/docs/api-reference/test-suites/list-suite-templates
> Source: https://github.com/langwatch/langwatch/blob/main/docs/api-reference/test-suites/list-suite-templates.mdx
> Index of all pages: https://langwatch.ai/docs/llms.txt

## Endpoint

`GET https://app.langwatch.ai/api/v1/test-suites/templates`

## Authentication

### project_api_key

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.

```json
{"id":"project_api_key","type":"apiKey","in":"header","name":"X-Auth-Token"}
```

## Request example

```bash
curl --request GET \
  --url 'https://app.langwatch.ai/api/v1/test-suites/templates' \
  --header "X-Auth-Token: $LANGWATCH_API_KEY"
```

## Responses

### 200

Success

#### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"},
      "version": {"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},
      "kind": {"type":"string","enum":["archetype","red_team_pack"]},
      "title": {"type":"string","minLength":1},
      "description": {"type":"string","minLength":1},
      "criteria": {"default":[],"type":"array","items":{"type":"string","minLength":1}},
      "scenarios": {
        "minItems": 1,
        "maxItems": 50,
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "key": {"type":"string","pattern":"^[a-z0-9_-]+$"},
            "name": {"type":"string","minLength":1},
            "situation": {"type":"string","minLength":1},
            "criteria": {
              "minItems": 1,
              "type": "array",
              "items": {"type":"string","minLength":1}
            },
            "labels": {"default":[],"type":"array","items":{"type":"string"}},
            "attack": {
              "type": "object",
              "properties": {
                "attackGoal": {"type":"string","minLength":1},
                "owaspIds": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^(LLM(0[1-9]|10)|ASI(0[1-9]|10))$"
                  }
                },
                "strategy": {"type":"string","enum":["crescendo","goat"]},
                "maxTurns": {"default":30,"type":"integer","minimum":1,"maximum":50}
              },
              "required": ["attackGoal","owaspIds","strategy","maxTurns"],
              "additionalProperties": false
            }
          },
          "required": ["key","name","situation","criteria","labels"],
          "additionalProperties": false
        }
      }
    },
    "required": ["id","version","kind","title","description","criteria","scenarios"],
    "additionalProperties": false
  }
}
```

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.
