Skip to main content

Topics

GET /v1/spaces/{space}/topics lists the space's live, world-readable topics. It returns only the lean fields needed to label and filter public posts:

  • id — the stable topic ID; pass it as topic to the posts listing.
  • name — the topic's display name.
  • description — the topic description, or null.

Topics are ordered by name ascending, then id ascending, and use the cursor pagination conventions shared by the other listings. A private, deleted, or otherwise gated topic is absent. A space without a public profile returns the same 404 Not Found as a missing space.

curl 'https://api.dfos.com/v1/spaces/field-notes/topics?limit=20'

Use a returned topic ID to list its public posts:

curl 'https://api.dfos.com/v1/spaces/field-notes/posts?topic=topic_8m2q7v4k'

An unknown, gated, or foreign topic ID produces an empty posts page, never an error. This deliberately does not reveal whether an ineligible topic exists.