templates

Replay Handoff Prompt

Queue a handoff-prompt replay and return immediately.

The actual LLM call runs in a background task (it takes ~30-60s, too long for the ALB's 60s timeout). Poll GET /{template_id}/handoff-prompt/replay for the result — envelope status: pending | ok | failed.

Reconstructs the LLM state the speaker had at end-of-call: the ONBOARDING template's system_instructions + full seed transcript + current user-template state. Asks Claude to produce EXACTLY the handoff text it would have sent via send_chat_message.

Body (all optional): onboarding_template_id: override the onboarding template whose system_instructions guide the generated prompt. Default: whatever template actually guided the seed interview. seed_interview_id: override the seed interview. Default: the one linked via interviews.context.created_template_id.

post/v1/templates/{template_id}/handoff-prompt/replay

Request

Base URL
https://api.roxels.ai (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/roxels/apis/interviewer/docs/v1/templates/:template_id/handoff-prompt/replay/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

template_idstring required

Request body

onboarding_template_idstring nullable

seed_interview_idstring nullable

Response

Successful Response

unknown required

Changes

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