Topics

A topic is a subject your organization knows about. See How Mereon is organized for the model.

List topics

GET /v1/topics

Cursor-paginated, optionally filtered by category. Returns the latest state by default.

Query parameters

Parameter	Type	Notes
`categorySlug`	string	Restrict to one category.
`cursor`	string	Pagination cursor from a previous response.
`limit`	number	1–100. Default 50.
`includeHistory`	boolean	Include archived and superseded topics. See Lifecycle.

Request

curl "https://api.mereon.ai/v1/topics?limit=50" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

{
  "data": [
    {
      "id": "top_9f2a...",
      "name": "Expense approval",
      "slug": "expense-approval",
      "description": "How expenses are reviewed and approved.",
      "categorySlug": "finance",
      "status": "ACTIVE",
      "supersededById": null,
      "url": "https://mereon.ai/topics/expense-approval",
      "createdAt": "2026-01-12T09:00:00.000Z",
      "updatedAt": "2026-05-30T16:20:00.000Z"
    }
  ],
  "nextCursor": "eyJpZCI6Im..."
}

Get a topic

GET /v1/topics/{id}

Topic detail: description, category, item summaries, and related topics.

Query parameters

Parameter	Type	Notes
`includeHistory`	boolean	Include archived and superseded records.

Response

{
  "id": "top_9f2a...",
  "name": "Expense approval",
  "slug": "expense-approval",
  "description": "How expenses are reviewed and approved.",
  "categorySlug": "finance",
  "status": "ACTIVE",
  "supersededById": null,
  "url": "https://mereon.ai/topics/expense-approval",
  "createdAt": "2026-01-12T09:00:00.000Z",
  "updatedAt": "2026-05-30T16:20:00.000Z",
  "category": { "slug": "finance", "title": "Finance" },
  "items": [
    {
      "id": "itm_2c8b...",
      "topicId": "top_9f2a...",
      "type": "process",
      "title": "Approve an expense over $500",
      "status": "ACTIVE",
      "supersededById": null,
      "url": "https://mereon.ai/items/itm_2c8b"
    }
  ],
  "relatedTopics": [
    {
      "id": "top_5d1e...",
      "name": "Corporate cards",
      "slug": "corporate-cards",
      "relationship": "related",
      "direction": "outgoing",
      "url": "https://mereon.ai/topics/corporate-cards"
    }
  ]
}

List items under a topic

GET /v1/topics/{id}/items

The processes, policies, and facts under a topic, returned as a nested tree (an item’s sub-steps appear in its children). See Items for the full item shape and evidence.

Query parameters

Parameter	Type	Notes
`includeHistory`	boolean	Include archived and superseded items.

curl "https://api.mereon.ai/v1/topics/top_9f2a/items" \
  -H "Authorization: Bearer $MEREON_TOKEN"