Topics

Get topic

Get a topic by ID

get/topics/{topicId}

Request

  • Base URL: https://api.modem.dev/v1
  • URL: https://api.modem.dev/v1/topics/{topicId}
  • Auth: HTTP bearer

Path parameters

string uuid required
OR
string uuid required

Response

OK

archivedAtstring date-time nullable

Timestamp when the topic was archived.

archivedReasonstring nullable required

Optional reason for archiving.

createdAtstring date-time
eventCountinteger required

Number of events grouped under this topic.

graphStatus'active' | 'archived' | 'superseded'

Graph-structural lifecycle: active (live), superseded (system-dissolved, terminal), archived (user-dismissed, retains members).

issueType'bug_report' | 'complaint' | 'discussion' | 'feature_request' | 'praise' nullable required

Classification for the topic as a type of issue.

keywordsstring[] required

Keywords associated with the topic.

lifecycleState'completed' | 'dismissed' | 'in_progress' | 'open' | 'unknown' nullable required

LLM-assessed lifecycle state for a topic.

lifecycleStateConfidencenumber nullable required

Confidence for the most recent lifecycle assessment.

priority'default' | 'high' | 'low' | 'very_high' | 'very_low' required

Priority level: very_low, low, default, high, or very_high

priorityReasoningstring nullable required

Reasoning from the most recent automatic topic-priority scoring decision. Null when priority was manually overridden or never auto-scored.

summarystring required

Descriptive summary of the topic.

supersededAtstring date-time nullable

Timestamp when a v2 topic was superseded; null unless graphStatus is superseded.

timeRangeEndunknown
timeRangeStartunknown
titlestring required

Short human-readable title of the topic.

updatedAtstring date-time

Timestamp when the topic was last updated.

Changes

No recorded changes to this operation across all 1 revision of this API.