---
title: "Get chronological timeline of messages and commits for a chat session"
method: GET
path: "/chat/sessions/{session_id}/timeline"
tags: ["chat"]
---

# Get chronological timeline of messages and commits for a chat session

`GET /chat/sessions/{session_id}/timeline`

## Path parameters

- `session_id` string, uuid, required

## Response `200`

Session timeline retrieved successfully

- GetSessionTimelineResponse — Response structure for getting session timeline
  - `timeline` TimelineItem[], required — Chronologically sorted list of messages and commits
    - union
      - object
        - `chat_session_id` string, uuid, required
        - `content` string, required
        - `content_proto` string, binary, nullable
        - `created_at` string, date-time, required
        - `git_commit_id` string, uuid, nullable
        - `id` string, uuid, required
        - `role` string, required
        - `slack_channel_id` string, nullable
        - `slack_message_ts` string, nullable
        - `slack_thread_ts` string, nullable
        - `stream_chunks` StreamChunkEntry[], nullable
          - `chunk_type` string, required
          - `content` string, required
        - `teams_channel_id` string, nullable
        - `teams_conversation_id` string, nullable
        - `teams_message_id` string, nullable
        - `timestamp` string, date-time, required
        - `type` 'Message', required
      - object
        - `chat_session_id` string, uuid, required
        - `commit_hash` string, required
        - `created_at` string, date-time, required
        - `id` string, uuid, required
        - `type` 'GitCommit', required

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