Skip to content
MereonMereonMereon Docs

Spaces and categories

Topics do not sit in a flat list. Each belongs to a space, and each space belongs to a category: category → space → topic → item. Reading those two levels tells you where a subject lives before you start filtering topics.

See How Mereon is organized for the model.

List spaces

Section titled “List spaces”

GET /v1/spaces

Every space the caller can read, optionally filtered to one category.

Query parameters

Section titled “Query parameters”
Parameter Type Notes
categorySlug string Restrict to one category. An unknown slug is rejected rather than returning nothing.

Request

Section titled “Request”
Terminal window
curl "https://api.mereon.ai/v1/spaces?categorySlug=finance" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

Section titled “Response”
{
  "data": [
    {
      "id": "spc_4c81...",
      "slug": "expenses-and-reimbursement",
      "name": "Expenses and reimbursement",
      "categorySlug": "finance",
      "description": "How money spent on the company's behalf is claimed back.",
      "topicCount": 7,
      "url": "https://mereon.ai/spaces/expenses-and-reimbursement"
    }
  ]
}

topicCount is the organization-wide number of topics in the space. It is deliberately not narrowed to what the calling token can read, so two tokens with different visibility report the same count. Use /v1/spaces/{id} when you need the topics themselves, which are scoped to the caller.

Get a space

Section titled “Get a space”

GET /v1/spaces/{id}

The space together with the topics it contains.

Response

Section titled “Response”
{
  "space": {
    "id": "spc_4c81...",
    "slug": "expenses-and-reimbursement",
    "name": "Expenses and reimbursement",
    "categorySlug": "finance",
    "description": "How money spent on the company's behalf is claimed back.",
    "topicCount": 7,
    "url": "https://mereon.ai/spaces/expenses-and-reimbursement"
  },
  "topics": [
    {
      "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"
    }
  ]
}

Topics are the current ones only. Archived and superseded topics are left out, the same rule the topics endpoints follow by default.

List categories

Section titled “List categories”

GET /v1/categories

The category catalog with the titles and descriptions this organization uses. Useful before filtering topics or spaces, since categorySlug filters expect a slug from this list.

Request

Section titled “Request”
Terminal window
curl "https://api.mereon.ai/v1/categories" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

Section titled “Response”
{
  "data": [
    {
      "slug": "finance",
      "title": "Finance",
      "description": "Money in, money out, and the controls around both.",
      "url": "https://mereon.ai/categories/finance"
    }
  ]
}