templates

Share Template Link

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

post/v1/templates/{template_id}/share

Path parameters

template_idstring required

Request body

emailstring nullable
namestring nullable
send_emailboolean
interview_idstring nullable

Response

Successful Response

{"stackTrail":"paths:/v1/templates/{template_id}/share:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.