---
title: "actor.timeline.read · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/actor.timeline.read"
updated: null
---

# actor.timeline.read · OpenVibe.Services

HTML: [actor.timeline.read · OpenVibe.Services](https://openvibe.services/docs/capabilities/actor.timeline.read)

# `actor.timeline.read`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Not grantable to apps (active, first-party).

Read one person's agent timeline from OpenVibe.Actor (design 2026-11-07): what the agent did in every mode, newest first, with a cursor and the mode and needs-you filters, as agent.timeline-list-result@1. GET /api/v1/agent/timeline. Only the person's own entries; titles, outcomes and links only, never a prompt or a diff.

- Owner: actor (token audience `openvibe.actor`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: none
- Quota class: standard
- Permissions: actor:read
- Input: [common.no-body@1](/docs/contracts/common.no-body)
- Output: agent.timeline-list-result@1
- Events: —
- Implemented by: - `GET /api/v1/agent/timeline`
- `GET /api/v1/agent/timeline/stream`

[These routes in the API explorer](/docs/api/actor#cap-actor.timeline.read)