Create Session

Create a persistent conversation session. Use the returned session_id with the chat endpoint to maintain context across messages.

POST /api/v1/sessions

cURL

custom_id

curl --request POST \
  --url https://ninjachat.ai/api/v1/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "user-alice-session-1"
}
'

201

{
  "session_id": "<string>",
  "message_count": 123,
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

API key starting with nj_sk_

Body

application/json

session_id · string

Optional stable identifier for this session (e.g. user-123-session-1). If omitted, a session_id is auto-generated.

metadata · object

Optional metadata to associate with the session.

Response

201

application/json

Session created.

session_id · string

message_count · integer

created_at · string<date-time>