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.
Apply a suite template
Create a test suite from a template, with one scenario per template scenario filled from the fit: the agent's name, its tools and what it must never do. The suite name defaults to the template title. An unknown template id answers 404 suite_template_not_found.
Try this endpoint
app.langwatch.ai
API key · X-Auth-Token
Kept in this tab. Cleared when you reload.
Body (application/json)
This sends a live request to app.langwatch.ai.
Request and response examples
request.py
import osimport requestsorigin = "https://app.langwatch.ai"path = "/api/v1/test-suites/templates/<templateId>/apply"api_key = os.environ["LANGWATCH_API_KEY"]headers = { "X-Auth-Token": api_key, "Content-Type": "application/json",}payload = { "fit": {},}response = requests.post( origin + path, headers=headers, json=payload,)print(response.json())const url = "https://app.langwatch.ai/api/v1/test-suites/templates/<templateId>/apply";const response = await fetch(url, { method: "POST", headers: { "X-Auth-Token": process.env.LANGWATCH_API_KEY!, "Content-Type": "application/json", }, body: JSON.stringify({ "fit": {} }),});const data = await response.json();curl --request POST \ --url 'https://app.langwatch.ai/api/v1/test-suites/templates/<templateId>/apply' \ --header "X-Auth-Token: $LANGWATCH_API_KEY" \ --header 'Content-Type: application/json' \ --data '{"fit":{}}'Call the LangWatch API from this project: Apply a suite template.Request: POST https://app.langwatch.ai/api/v1/test-suites/templates/<templateId>/applyReference: https://langwatch.ai/docs/api-reference/test-suites/apply-a-suite-template.mdAuthentication: send the X-Auth-Token header, read from the LANGWATCH_API_KEY environment variable. Never hard-code the key.Body (application/json):```json{ "fit": {}}```Use the HTTP client this project already uses, handle non-2xx responses, and show me the parsed result.Success
application/json · Generated from schema
{ "suiteId": "string", "slug": "string", "name": "string", "scenarioIds": [ "string" ]}Not Found
application/json · Generated from schema
{ "error": "string", "message": "string", "code": "string"}Path parameters
templateIdstringrequiredUp to 80 charactersPattern ^[a-z0-9]+(-[a-z0-9]+)*$
Request body
application/json · Required
fitobjectrequirednamestringAt least 1 characterUp to 200 characters
Responses
201Success
application/json
suiteIdstringrequiredAt least 1 character
slugstringrequiredAt least 1 character
namestringrequiredAt least 1 character
scenarioIdsstring[]required404Not Found
application/json
errorstringrequiredmessagestringcodestringrequired