Issues

As your knowledge base grows, Mereon flags issues: conflicts, duplicates, gaps, and stale or misclassified knowledge. This endpoint exposes them so a tool or dashboard can surface what needs attention.

List issues

GET /v1/issues

Most recent first, cursor-paginated, scoped to issues whose targets you can see.

Query parameters

Parameter	Type	Notes
status	string	OPEN, IN_PROGRESS, RESOLVED, or DISMISSED.
type	string	CONFLICT, DUPLICATE, MISCLASSIFICATION, STALE, CONTENT_GAP, STRUCTURE_GAP, or OTHER.
severity	string	CRITICAL, HIGH, MEDIUM, or LOW.
assignedToMe	boolean	Only issues assigned to the connected user.
cursor	string	Pagination cursor from a previous response.
limit	number	1–100. Default 50.

Request

curl "https://api.mereon.ai/v1/issues?status=OPEN&severity=HIGH" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

{
  "data": [
    {
      "id": "iss_4f9c...",
      "type": "CONFLICT",
      "severity": "HIGH",
      "status": "OPEN",
      "title": "Two documents disagree on the expense approval threshold",
      "description": "The Finance Handbook says $500; the Travel Policy says $750.",
      "assignedToName": "Alex Doe",
      "assignedToRoleName": null,
      "raisedByName": null,
      "targets": [
        { "targetType": "TOPIC", "targetId": "top_9f2a...", "title": "Expense approval" }
      ],
      "createdAt": "2026-06-01T09:00:00.000Z",
      "resolvedAt": null
    }
  ],
  "nextCursor": null
}

Fields

Field	Type	Notes
type	string	The kind of issue (see the parameter table).
severity	string	CRITICAL, HIGH, MEDIUM, or LOW.
status	string	OPEN, IN_PROGRESS, RESOLVED, or DISMISSED.
title	string	Short summary of the issue.
description	string | null	Longer explanation, when present.
assignedToName	string | null	Assigned user’s display name, when assigned to a person.
assignedToRoleName	string | null	Assigned role’s name, when assigned to a role.
raisedByName	string | null	Who raised it (manual issues only).
targets	object[]	The entities the issue concerns, each with targetType, targetId, and title.
resolvedAt	string | null	When it was resolved, or null if still open.