---
title: "Get Session Details"
method: GET
path: "/api/assistant/sessions/{sessionId}"
tags: ["Assistant"]
---

# Get Session Details

`GET /api/assistant/sessions/{sessionId}`

Retrieve the complete chat history and usage for a specific session. Can lookup deleted sessions.

## Path parameters

- `sessionId` string, required

## Response `200`

Complete chat history and session details

- ModelAssistantSessionDetails — Detailed information about an Assistant session, including its messages.
  - `history` ModelStoredMessage[] — The messages in the session.
    - `createTime` string — The date and time that this object was created. This is a read-only field.
    - `id` string — The ID assigned to this object by the server. This is a read-only field.
    - `kind` string — The kind of object. This is a read-only field.
    - `message` ModelMessage — The message content.
      - `id` string — The unique identifier for the message. Not required.
      - `role` string — Indicates who authored the message. Either `user` or `assistant`.
      - `stop_reason` string — The reason the message was stopped.
      - `stop_sequence` string — The sequence in which the message was stopped.
      - `thoughts` string — The plain text thoughts from the model's response
      - `usage` ModelUsage — Usage statistics after deducting the costs of the message.
        - `credits` integer — The number of credits remaining after this message.
        - `input_tokens` integer — The number of input tokens used.
        - `output_tokens` integer — The number of output tokens used.
    - `model` string — The model used for this message.
    - `operation` string — The operation that was applied to the object. This is a read-only field.
    - `session_id` string — What session this message belongs to.
    - `tags` string[] — Metadata about the message.
    - `updateTime` string — The date and time that this object was last modified. This is a read-only field.
    - `userId` string — The user ID (or API client ID) that initiated this event. This is a read-only field.
  - `session` ModelAssistantSession — Meta information about the session.
    - `createTime` string — The date and time that this object was created. This is a read-only field.
    - `deleteTime` string — The time the session was deleted.
    - `entityId` string — The entity ID associated with this session (e.g., alert soc_id).
    - `id` string — The ID assigned to this object by the server. This is a read-only field.
    - `kind` string — The kind of object. This is a read-only field.
    - `operation` string — The operation that was applied to the object. This is a read-only field.
    - `sessionId` string — The session identifier.
    - `tags` string[] — Metadata about the session.
    - `title` string — The title of the session. Usually the first message sent by the user.
    - `type` string — The type of session (e.g., "alert_investigation").
    - `updateTime` string — The date and time that this object was last modified. This is a read-only field.
    - `usage` ModelSessionUsage — Usage statistics for the session.
      - `modelUsage` object — Usage statistics per model@adapter combination.
      - `totalCredits` integer — The total credits used during the session.
      - `totalInputTokens` integer — The total input tokens used during the session.
      - `totalMessages` integer — The total messages sent during the session.
      - `totalOutputTokens` integer — The total output tokens used during the session.
    - `userId` string — The user ID (or API client ID) that initiated this event. This is a read-only field.

## Other responses

- `400` — The provided session ID is invalid or missing
- `401` — Request was not properly authenticated
- `403` — Insufficient permissions for this request
- `500` — Internal SOC error; review SOC logs

## Changes

- **2026-07-17** `0576ce393f8d` — 4 info
  - the security scope `assistant/read_authored` was added to the endpoint's security scheme `bearer`
  - the security scope `assistant/read_shared` was removed from the endpoint's security scheme `bearer`
  - added the optional property `history/items/model` to the response with the `200` status
  - added the optional property `session/usage/modelUsage` to the response with the `200` status
- **2026-02-27** `c7b650ad3d3e` — 1 breaking, 2 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the optional property `history` to the response with the `200` status
  - added the optional property `session` to the response with the `200` status
- **2025-10-23** `dd1538426ed4` — 1 info
  - endpoint added
- **2024-12-10** `ee1120fd1e20` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/security-onion-solutions/apis/security-onion-connect-api/changes/api/assistant/sessions/:sessionId/get.md)

---

[API](https://skmtc.dev/security-onion-solutions/apis/security-onion-connect-api.md) · [All operations](https://skmtc.dev/security-onion-solutions/apis/security-onion-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/security-onion-solutions/security-onion-connect-api/revisions/0576ce393f8d/schema)