Advisor

Edit Advisor Insight

Required scopes: project.advisor (Read and Write).

User-facing mutation of a single Advisor Insight row. Currently only /isDismissed is patchable (dismiss ↔ reactivate). For dispatching a fresh check, see POST /advisors/checks. For app-pushed insight updates, see PUT /applications/.../insight.

patch/projects/{projectId}/advisors/insights/{insightId}

Request

Path parameters

projectIdinteger required

Project Identifier. Get via List Projects

insightIdinteger required
Example:10

Insight Identifier

Request body

op'replace' | 'test' required

Patch operation to perform

path'/isDismissed' json-pointer required

A JSON Pointer as defined by <a href="https://tools.ietf.org/html/rfc6901" target="_blank">RFC 6901</a>

Response

Advisor insight was successfully updated

Example response

{
  "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"
    }
  }
}

Changes

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