---
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

---

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