---
title: "Get Timeline"
method: POST
path: "/ai/timeline"
tags: ["agent"]
---

# Get Timeline

`POST /ai/timeline`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/ai/timeline`
- Auth: none declared

Load full timeline for a session.

Returns all timeline events including:
- Messages (user/assistant)
- Tool executions with parameters and results
- Plan summaries
- User prompts

This enables Cursor-like session restoration where the full
conversation context is restored after page refresh.

SECURITY: Verifies user owns the session.

Args:
    request: Request with session_id and pagination
    user: Current user (from JWT)

Returns:
    List of timeline events with pagination

## Request body

- GetTimelineRequest: Request to load session timeline.
  - `session_id` string, required
  - `limit` integer
  - `offset` integer
  - `event_types` string[], nullable

## Response `200`

Successful Response

- GetTimelineResponse: Response with session timeline events.
  - `events` object[], required
  - `total` integer, required
  - `has_more` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)