Advisor

List Advisor Insights

Required scopes: project.advisor (Read only).

get/projects/{projectId}/advisors/insights

Request

Path parameters

projectIdinteger required

Project Identifier. Get via List Projects

Query parameters

limitinteger

A maximum number of items to retrieve

offsetinteger

A starting offset in the collection

isDismissedboolean

Filter insights by dismissal flag. Omit to return both dismissed and active insights.

statusstring
Example:pending,checking,outdated,done

Filter insights by status (comma-separated)

outcomestring
Example:flagged,clear

Filter insights by outcome (comma-separated). flagged — issue detected; clear — on target; not_applicable — does not apply. Omit to return all checked insights (never-checked ones are excluded).

Response

Advisor insights list

Example response

{
  "data": [
    {
      "data": {
        "id": 10,
        "inspectorKey": "string_context_relevance",
        "category": "context",
        "status": "done",
        "outcome": "flagged",
        "severity": "high",
        "refreshPolicy": "hourly",
        "metrics": [
          {
            "key": "quality_score",
            "value": 12,
            "unit": "percent",
            "threshold": 50,
            "tone": "danger",
            "source": "deterministic",
            "checkedAt": "2026-04-06T10:30:00+00:00"
          }
        ],
        "recommendations": [
          {
            "id": "run_ai_context_validation",
            "primary": true
          }
        ],
        "checkedAt": "2026-04-06T10:30:00+00:00",
        "lastAiRun": {
          "mode": "auto",
          "promptId": 42,
          "at": "2026-04-06T10:30:00+00:00"
        }
      }
    }
  ],
  "pagination": {
    "limit": 25,
    "total": 25
  }
}

Changes

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