Skip to main content
POST
/
ingest
/
stream
POST /ingest/stream
curl --request POST \
  --url https://api.example.com/ingest/stream \
  --header 'Content-Type: application/json' \
  --data '
{
  "uid": "<string>",
  "text": "<string>",
  "ts": "<string>",
  "source": "<string>"
}
'
{
  "status": "recorded",
  "distress_score": 6.8,
  "alert_fired": false
}
Single-item real-time ingestion for Model B (Signal/Brain tiers). Designed for Slack webhooks where messages arrive individually. Returns a distress score so the connector can act locally if needed.

​
Request body

​
uid
string
required
Pseudonymous user identifier — customer holds the mapping.
​
text
string
required
Message or comment text.
​
ts
string
ISO 8601 timestamp of the original message.
​
source
string
Content source label.

​
Response

​
status
string
recorded.
​
distress_score
float
Score from 0.0–10.0 for this message.
​
alert_fired
boolean
true if uid crossed alert threshold.

​
Example

curl -X POST "https://api.togetherwithkai.com/v1/affective/ingest/stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "usr_a1b2c3",
    "text": "I dont know if anyone would notice if I wasnt here",
    "ts": "2026-06-15T14:22:00Z",
    "source": "slack_engineering"
  }'

{
  "status": "recorded",
  "distress_score": 6.8,
  "alert_fired": false
}