webhooks

Discovery Handoff Webhook

End-of-Discovery handoff: create the specialist setup interview.

Receives the discovery template's structured-extraction payload at the end of the call: { "event": "complete", "interview_id": "<discovery interview id>", "person_name": "...", "data": { # extracted via DISCOVERY_FINDINGS_SCHEMA "archetype_match": "embedded" | ... | "not_a_fit" | "unsure", "caller_context": "...", "problem_shape": "...", "surrounding_context": "...", "pattern_recognized": "...", "fit_assessment": {"verdict": "yes|partial|no", "reason": "..."}, "readiness_signal": "explorer|builder|skeptic", "prefill_fragments": [{"raw_text": "...", "context": "..."}, ...], }, "timestamp": "..." }

Writes context.discovery_handoff on the discovery interview with one of: {"status": "ready", "next_interview_id": ..., "next_session_id": ..., "archetype_match": ..., "kind": ...} {"status": "not_a_fit", "reason": ...} {"status": "error", "reason": ...}

Frontend polls GET /api/proxy/interviews/{discoveryInterviewId} and reads that block to advance.

post/v1/webhooks/discovery-handoff

Request body

object required

Response

Successful Response

{"stackTrail":"paths:/v1/webhooks/discovery-handoff: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.