fetch_topic
Retrieve every message tied to a specific topic tag in a project, regardless of recipient, to review topic threads and filter by recency or unread status.
Instructions
Fetch all messages in a project with a given topic tag, regardless of recipient.
Parameters
project_key : str
Project identifier.
topic_name : str
The topic tag to filter by (case-insensitive).
limit : int
Max number of messages to return (default 50).
include_bodies : bool
Include full Markdown bodies in the payloads (default true).
since_ts : Optional[str]
ISO-8601 timestamp; only messages newer than this are returned.
unread_only : bool
When True, restrict to messages where the viewer has a recipient
row that has not been explicitly marked read. This narrows beyond
the default sender-or-recipient visibility — messages the viewer
sent (but is not a recipient of) and broadcast/thread-visible
messages where the viewer has no MessageRecipient row are
excluded under this flag, because "unread" is only well-defined
for a recipient row. A bare fetch_topic call does NOT mark
messages read.
Returns
list[dict] Each message includes: { id, subject, from, created_ts, importance, topic, [body_md] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| format | No | ||
| since_ts | No | ||
| agent_name | No | ||
| topic_name | Yes | ||
| project_key | Yes | ||
| unread_only | No | ||
| include_bodies | No | ||
| registration_token | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |