---
title: "Read Organization Session Timeline"
method: GET
path: "/waldo/organization/sessions/{session_id}/messages"
tags: ["Waldo"]
---

# Read Organization Session Timeline

`GET /waldo/organization/sessions/{session_id}/messages`

## Request

- Base URL: `https://api.cloud.wherobots.com`
- URL: `https://api.cloud.wherobots.com/waldo/organization/sessions/{session_id}/messages`
- Auth: HTTP bearer

A session in the caller's organization by its ID alone, as its owner
reads it, with `owner_id` and `owner_email`.

Public IDs are unique only per owner; where members share one, from before
creation refused it, the oldest session answers. Like the route by owner,
there is no stream.

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- OrganizationTimeline: A session's timeline as anyone in its organization reads it, with its owner as `OrganizationSessionSummary` names them.
  - `session` SessionSummary, required
    - `id` string, required
    - `status` string, required
    - `notify_on_final` boolean, required
    - `feedback` string, nullable, required
    - `feedback_reason` string, nullable, required
    - `title` string, nullable, required
    - `created_at` string, date-time, required
  - `messages` TimelineMessage[], required
    - `id` string, required
    - `role` 'user' | 'assistant', required
    - `status` string, required
    - `text` string, required
    - `reply_to` string, nullable, required
    - `sequence` integer, required
    - `events` object[], nullable, required
    - `created_at` string, date-time, required
    - `steps` TimelineStep[], required
      - `id` string, required
      - `step_index` integer, required
      - `kind` string, required
      - `status` string, required
      - `provider` string, nullable, required
      - `tool_name` string, required
      - `payload` object, required
      - `created_at` string, date-time, required
    - `error` string, nullable
    - `reason` string, nullable
  - `compactions` TimelineCompaction[], required
    - `through_message_id` string, required
    - `created_at` string, date-time, required
  - `owner_id` string, required
  - `owner_email` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-10-22** `f86201feeefa`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wherobots/apis/wherobots-cloud-api/changes/waldo/organization/sessions/:session_id/messages/get.md)

---

[API](https://skmtc.dev/wherobots/apis/wherobots-cloud-api.md) - [All operations](https://skmtc.dev/wherobots/apis/wherobots-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wherobots/apis/wherobots-cloud-api/revisions/10cad63c998a?raw)