Advisor

Create Advisor Check

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

Triggers an asynchronous re-check of advisor inspectors for the project. At most one of category or inspectors may be present; if neither is supplied, every inspector is re-checked. Supplying category re-checks all inspectors in that category. Supplying inspectors re-checks only the listed inspectors; pass options on an entry to opt into AI validation for that inspector. Returns a job-progress descriptor — distinct from PATCH /insights/{insightId} (user-facing Insight mutation) and PUT /applications/.../insight (app-pushed upsert).

post/projects/{projectId}/advisors/checks

Request

Path parameters

projectIdinteger required

Project Identifier. Get via List Projects

Request body

categorystring

Optional category to scope the check to. Mutually exclusive with inspectors.

Example request

{
  "category": "context",
  "inspectors": [
    {
      "key": "string_context_relevance",
      "options": {
        "mode": "auto",
        "promptId": 42
      }
    }
  ]
}

Response

Advisor check job created

Example response

{
  "data": {
    "identifier": "550e8400-e29b-41d4-a716-446655440000",
    "status": "created",
    "attributes": {
      "category": "context",
      "inspectors": [
        {
          "key": "string_context_relevance"
        }
      ]
    },
    "createdAt": "2026-04-16T12:00:00+00:00",
    "updatedAt": "2026-04-16T12:00:00+00:00"
  }
}

Changes

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