---
title: "List knowledge topics"
method: GET
path: "/api/v1/topics"
---

# List knowledge topics

`GET /api/v1/topics`

## Request

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

Lists all knowledge topics visible to the user with role, counts, and last activity. Topics are shared knowledge scopes referenced as T-1, T-2, …

## Query parameters

- `include_archived` boolean

## Response `200`

Visible topics.

- object: Topic list.
  - `topics` TopicListEntry[]: Topics visible to the caller, most recently active first.
    - `id` string: Topic UUID.
    - `number` string: Short reference, e.g. T-3.
    - `name` string: Unique name.
    - `description` string, nullable: Description.
    - `visibility` 'private' | 'workspace': Visibility.
    - `status` 'active' | 'archived': Status.
    - `my_role` 'admin' | 'writer' | 'reader': The caller's effective role.
    - `member_count` integer: People with explicit access.
    - `document_count` integer: Number of documents.
    - `linked_task_count` integer: Number of linked tasks.
    - `last_activity_at` string: Last event (ISO 8601).
    - `created_at` string: Creation time (ISO 8601).
    - `updated_at` string: Last change (ISO 8601).

## Other responses

- `401`: The access token is missing or invalid.

---

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