Ingest message

Changed on

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

Request

  • The document declares no server URL.
  • Auth
    none declared

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

  • ba1ceff8b2ffRevision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

  • 3e3822f627bdRevision changes
    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property