---
title: "Share Template Link"
method: POST
path: "/v1/templates/{template_id}/share"
tags: ["templates"]
---

# Share Template Link

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

Generate a join link for a template. No date, no calendar invite.

Two modes, with very different semantics:

- **With email** (`body.email` set): the link is tied to that specific
  person via a pre-created interview row. A return click on this URL
  resumes the conversation ("welcome back"). Use when you know who you're
  sending to — a single recipient. URL shape: `/join/i/<interviewId>`.
- **Without email** (`body.email is None`): the link is generic. Each
  click spawns a fresh interview+session so two strangers don't walk
  into each other's conversation. URL shape: `/join/t/<templateId>`.
  We do NOT pre-create an interview here — that happens lazily on the
  first click via `POST /v1/templates/{id}/join-public`.

If `send_email` is true and an email is provided, the link is emailed as
a plain invitation (no ICS attachment).

## Path parameters

- `template_id` string, required

## Request body

- ShareLinkRequest
  - `email` string, nullable
  - `name` string, nullable
  - `send_email` boolean
  - `interview_id` string, 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)