Get Conversation

GET/api/v1/conversations/{session_id}

Fetch the complete ordered message history for a single conversation session.

Required scope: read

Path parameters

session_idstringpathrequired

The conversation session identifier.

Response

session_idstring

The session identifier.

messagesarray

All messages in the session, oldest to newest. Each has id, role, content, feedback_rating, created_at.

Example

cURL

curl "https://api.personaliai.com/api/v1/conversations/visitor-xyz-789" \
  -H "Authorization: Bearer chatty_sk_your_key"

200 OK:

{
  "session_id": "visitor-xyz-789",
  "messages": [
    { "id": "msg-010", "role": "user", "content": "Hi, do you have enterprise plans?", "feedback_rating": null, "created_at": "2026-07-06T14:20:00Z" },
    { "id": "msg-011", "role": "assistant", "content": "Yes! Our Enterprise plan includes unlimited bots, SSO, and dedicated support.", "feedback_rating": "up", "created_at": "2026-07-06T14:20:03Z" }
  ]
}

404 — session not found:

{ "detail": "Session not found or belongs to a different bot" }

List Conversations

Clear Session