v1

latestOpenAPI 3.1.12026-07-17146175447.5 KB

Ingest message

Send a message as if from user input (e.g. from another port or service). Creates a new session if sessionID is missing or invalid. AI response streams into the same session and appears in TUI chat.

post/session/ingest

Query parameters

directorystring

Request body

textstring required

Message text (treated as user input)

sessionIDstring

Existing session id; omit or leave invalid to create a new session

agentstring

Agent to use (default if omitted)

credential_idstring

Existing credential ID to use for this request

trigger_elementstring

UI element that triggered this request (role:label)

element_rolesstring[]

Roles that can see the trigger element

ui_contextobject

UI form context at request time

page_urlstring

Page being explored when request was captured

page_visited_bystring[]

Roles that can visit this page

scheme'http' | 'https'

URL scheme of the captured request; inferred from Host header / port when omitted

Response

Message accepted

sessionIDstring required

Session id (new or existing); use for follow-up ingest requests