Create a NEO session

POST /sessions

Create a session with a server-minted UUID — the BE-owned id-generation path. Always creates a new session (a ticket may have many; the UI decides how many). This is an additional path, not a replacement: a client may still lazily create a session by POSTing its first message with a self-minted UUID (see POST /sessions/{id}/messages). The human agent caller is recorded as a participant; an internal (cortex) caller creates an unowned session. costUsd/model in the response are only included when the caller has reportAiPerformance.

Request body

{
  "ticketId": 1
}

Responses

201 — Session created

{
  "session": {
    "id": "string",
    "ticketId": 1,
    "lastActivityAt": "2026-01-01T12:00:00Z",
    "createdAt": "2026-01-01T12:00:00Z",
    "participants": [
      {
        "id": 1,
        "name": "string"
      }
    ],
    "messageCount": 1,
    "costUsd": 1,
    "model": "string"
  },
  "success": true
}

401 — Unauthorized