---
title: "Ingest message"
method: POST
path: "/session/ingest"
---

# Ingest message

`POST /session/ingest`

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.

## Query parameters

- `directory` string

## Request body

- object
  - `text` string, required — Message text (treated as user input)
  - `sessionID` string — Existing session id; omit or leave invalid to create a new session
  - `agent` string — Agent to use (default if omitted)
  - `model` object — Model to use (optional)
    - `providerID` string, required
    - `modelID` string, required
  - `credential_id` string — Existing credential ID to use for this request
  - `credential` object — New credential to register with this request
    - `label` string, required
    - `headers` object
    - `container_id` string
  - `response` object — HTTP response data
    - `status` number, required — HTTP status code
    - `headers` object, required — Response headers
    - `body` string, required — Response body
  - `trigger_element` string — UI element that triggered this request (role:label)
  - `element_roles` string[] — Roles that can see the trigger element
  - `ui_context` object — UI form context at request time
  - `page_url` string — Page being explored when request was captured
  - `page_visited_by` string[] — Roles that can visit this page
  - `scheme` 'http' | 'https' — URL scheme of the captured request; inferred from Host header / port when omitted

## Response `202`

Message accepted

- object
  - `sessionID` string, required — Session id (new or existing); use for follow-up ingest requests

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.net/cyberstrikeus/apis/cyberstrike.md) · [All operations](https://skmtc.net/cyberstrikeus/apis/cyberstrike/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyberstrikeus/cyberstrike/revisions/4e11f1aed2fd/schema)