---
title: "What's new in a topic"
method: GET
path: "/api/v1/topics/{ref}/updates"
---

# What's new in a topic

`GET /api/v1/topics/{ref}/updates`

## Request

- Base URL: `https://myagentda.com`
- URL: `https://myagentda.com/api/v1/topics/{ref}/updates`
- Auth: API key in header `Authorization`

Chronological events since a given time: new/changed documents, new members, newly linked tasks. Topics never push — this is the pull channel.

## Path parameters

- `ref` string, required

## Query parameters

- `since` string

## Response `200`

Chronological topic events.

- object: Topic with event entries.
  - `topic` Topic: A knowledge topic.
    - `id` string: Topic UUID.
    - `number` string: Short reference, e.g. T-3.
    - `name` string: Unique name.
    - `description` string, nullable: What belongs in this topic.
    - `visibility` 'private' | 'workspace': private: only named people. workspace: everyone reads.
    - `status` 'active' | 'archived': Archived topics are read-only.
    - `created_at` string: Creation time (ISO 8601).
    - `updated_at` string: Last change (ISO 8601).
  - `entries` object[]: Events in chronological order.
    - `seq` integer: Sequence number.
    - `at` string: Timestamp (ISO 8601).
    - `type` string: Event type.
    - `description` string: Human-readable description.

## Other responses

- `401`: The access token is missing or invalid.
- `404`: Not found — or not visible to the caller (no existence leak).

---

[API](https://skmtc.dev/myagentda/apis/agentda.md) · [All operations](https://skmtc.dev/myagentda/apis/agentda/llms.txt) · [OpenAPI document](https://skmtc.dev/myagentda/apis/agentda/revisions/66a449ab49dc?raw)