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

Changes

Changed in 7 of the 102 revisions of this API.11219

Apr 29, 2026ba1ceff8b2ff6See the full diff
- ○
  added the new optional request property element_roles
  new-optional-request-property
- ○
  added the new optional request property page_url
  new-optional-request-property
- ○
  added the new optional request property page_visited_by
  new-optional-request-property
- ○
  added the new optional request property scheme
  new-optional-request-property
- ○
  added the new optional request property trigger_element
  new-optional-request-property
- ○
  added the new optional request property ui_context
  new-optional-request-property
Apr 29, 20263e3822f627bd6See the full diff
- ●
  removed the request property element_roles
  request-property-removed
- ●
  removed the request property page_url
  request-property-removed
- ●
  removed the request property page_visited_by
  request-property-removed
- ●
  removed the request property scheme
  request-property-removed
- ●
  removed the request property trigger_element
  request-property-removed
- ●
  removed the request property ui_context
  request-property-removed
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 29, 2026ba1ceff8b2ff6See the full diff
- ○
  added the new optional request property element_roles
  new-optional-request-property
- ○
  added the new optional request property page_url
  new-optional-request-property
- ○
  added the new optional request property page_visited_by
  new-optional-request-property
- ○
  added the new optional request property scheme
  new-optional-request-property
- ○
  added the new optional request property trigger_element
  new-optional-request-property
- ○
  added the new optional request property ui_context
  new-optional-request-property
Apr 28, 20263e3822f627bd6See the full diff
- ●
  removed the request property element_roles
  request-property-removed
- ●
  removed the request property page_url
  request-property-removed
- ●
  removed the request property page_visited_by
  request-property-removed
- ●
  removed the request property scheme
  request-property-removed
- ●
  removed the request property trigger_element
  request-property-removed
- ●
  removed the request property ui_context
  request-property-removed
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 28, 2026ba1ceff8b2ff6See the full diff
- ○
  added the new optional request property element_roles
  new-optional-request-property
- ○
  added the new optional request property page_url
  new-optional-request-property
- ○
  added the new optional request property page_visited_by
  new-optional-request-property
- ○
  added the new optional request property scheme
  new-optional-request-property
- ○
  added the new optional request property trigger_element
  new-optional-request-property
- ○
  added the new optional request property ui_context
  new-optional-request-property
Mar 17, 2026437a6ea5aeb31See the full diff
- ○
  endpoint added
  endpoint-added
Jan 20, 2026c7ae6a68e4fb1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 36 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history