---
title: "Get a chat session with all its messages"
method: GET
path: "/chat/sessions/{session_id}"
tags: ["chat"]
---

# Get a chat session with all its messages

`GET /chat/sessions/{session_id}`

## Path parameters

- `session_id` string, required

## Response `200`

Chat session retrieved successfully

- GetChatSessionResponse — Response for getting a chat session
  - `session` ChatSessionWithEvents, required
    - `commits` GitCommit[], required
      - `chat_session_id` string, uuid, required
      - `commit_hash` string, required
      - `created_at` string, date-time, required
      - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `git_application_token` string, required
    - `id` string, uuid, required
    - `is_favorite` boolean, required
    - `latest_workflow_session_id` string, uuid
    - `messages` ChatEventWithRole[], required
      - `content` union, required — Events in a chat session timeline, including messages and unified tool calls/results
        - object
          - `TextMessage` object, required
            - `message` string, required
        - object
          - `Thinking` object, required
            - `block_id` integer, required
            - `complete` boolean, required
            - `content` string, required
        - object
          - `File` object, required — The file event can't be serialized to the database safely without the content. When streaming, we start with the path only, then add the content as we go.
            - `block_id` integer, required
            - `complete` boolean, required
            - `content` string, nullable
            - `path` string, required
        - object
          - `Action` object, required
            - `actions` ActionDef[], required
              - …
            - `block_id` integer, required
            - `complete` boolean, required
        - object
          - `Connector` object, required
            - `description` string, nullable
            - `env_vars` string[], required
            - `name` string, required
        - object
          - `ToolCall` object, required
            - `block_id` integer, required
            - `complete` boolean, required
            - `invocation` union, required
              - …
            - `tool_result` union, required
              - …
        - object
          - `Question` object, required
            - `block_id` integer, required
            - `complete` boolean, required
            - `content` string, required
            - `options` string[], required
        - object
          - `InternalError` object, required
            - `message` string, required
        - object
          - `ReviewRequest` object, required
            - `node_summaries` NodeSummary[], required
              - …
        - object
          - `AttachedFile` object, required
            - `image_bytes` string, binary, nullable
            - `path` string, required
        - object
          - `ConnectorRequest` object, required
            - `connector_id` string, uuid, required
      - `message_id` string, uuid, required
      - `role` 'user' | 'system' | 'assistant', required
      - `timestamp` string, date-time, required
    - `name` string, nullable
    - `project_id` string, uuid
    - `slack_channel_id` string, nullable
    - `slack_team_id` string, nullable
    - `slack_thread_ts` string, nullable
    - `team_id` string, uuid, required
    - `title` string, required
    - `updated_at` string, date-time, required
    - `user_message_needed` boolean, required
    - `user_role` 'viewer' | 'editor' | 'owner', required
    - `visibility` 'private' | 'shared_with_team' | 'public', required
    - `workflow_schedule_id` string, uuid

## Other responses

- `400` — Invalid session ID format
- `404` — Chat session not found
- `500` — Internal server error

---

[API](https://skmtc.net/structifyai/apis/structify.md) · [All operations](https://skmtc.net/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/structifyai/structify/versions/1364930b6980/schema)