LIlinktodm
flow_automation
flow_automation_ai_builder

Post Ai Builder Turn

Run one user turn as a Server-Sent Events stream.

Response body is text/event-stream. Each event is one JSON object on a data: line, with a blank line terminator. The client parses event to dispatch (see schemas.ChatTurnEvent).

When payload.flow_automation_id (saved flow) or payload.draft_key (unsaved /create flow) is supplied, the turn is persisted to FlowAiChatSession for cross-reload continuity.

Gated by the plan token quota: free users are blocked, Pro/Pro+ have a monthly token budget. The check runs BEFORE the stream so a blocked user gets a clean 402 (not a half-streamed error); test/exempt users skip it. Usage is recorded inside run_turn after the turn runs.

post/v1/flow_automation/ai_builder/turn

Request

  • Base URL
    https://api.linktodm.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

messagestring required
nodesobject[]
edgesobject[]
historyobject[]
media_sourcestring nullable
flow_automation_idinteger nullable
draft_keystring nullable

Response

Successful Response

unknown required

Changes

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