fde
fde-conversations

Get Or Create Ambient Conversation

Flywheel V1.3 — get-or-create the subject's ambient FDE conversation.

Subject-polymorphic via XOR query params: exactly one of voice_agent_id or voice_agent_group_id must be set; passing both or neither returns 400. The ambient conversation is the one where flywheel_run_id IS NULL — distinct from cycle-scoped conversations created by V1.1a's preview_plan. The cockpit reads this on mount in readonly mode (no active cycle); cycle conversations are surfaced via ActiveCycleResponse.conversation_id instead.

Auto-creates if the subject has no prior ambient conversation, so the cockpit always has somewhere to stream into. Idempotent: two sequential calls return the same conversation id (modulo the documented V1.3 race for concurrent first-mount; V1.2 closes that with a partial unique index).

Returns FDEConversationDetailRead with messages populated so the cockpit's first paint already has chat history without a second round-trip.

get/api/v1/fde/conversations/ambient

Query parameters

voice_agent_idstring uuid nullable
voice_agent_group_idstring uuid nullable

Response

Successful Response

idstring uuid required
tenant_idstring uuid required
user_idstring uuid required
context_typestring required
target_agent_typestring nullable required
target_agent_idstring uuid nullable required
target_group_typestring nullable
target_group_idstring uuid nullable
titlestring nullable required
previewstring nullable required
last_message_atstring date-time nullable required
message_countinteger required
langgraph_thread_idstring nullable required

Changes

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