---
title: "Test Template"
method: POST
path: "/v1/templates/{template_id}/test"
tags: ["templates"]
---

# Test Template

`POST /v1/templates/{template_id}/test`

Create a test interview and session in one shot, returning a join URL
for immediate testing.

Phase A versioning behavior — caller decides whether to test the
specific version (passed id) or whichever is currently active in the
lineage:

- Detail page (admin viewing a specific version): passes
  `pin_specific_version: true` so we test THE selected version even
  when it's inactive. Lets "create v2 → test v2 → promote" work
  without first making v2 production-live.
- List view (admin clicked Test on the row): default behavior —
  `pin_specific_version` is missing/false, we resolve to the active
  version of the lineage so the test mirrors what real users get.

## Path parameters

- `template_id` string, required

## Request body

- object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/roxels/apis/interviewer.md) · [All operations](https://skmtc.dev/roxels/apis/interviewer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roxels/interviewer/revisions/4ef48ed226e1/schema)