Re-run AI processing for a quality assessment

`POST /quality/assessment/{id}/refresh`

Re-runs the AI processing of an existing assessment, regenerating AI-scored criteria and the AI summary.

By default, the assessment is upgraded to the latest active scorecard revision (resolved by baseId). To pin processing to a specific revision, pass scorecardId in the request body — it must belong to the same scorecard family (same baseId) as the assessment's current revision.

The user must have permission to edit this assessment. Cannot be called when the assessment is in discussedWithAssessee or reviewedBySupervisor state.

Path parameters

idintegerpathrequired

Assessment ID

Request body

scorecardIdintegerbody

Optional. Specific scorecard revision id to use for processing. Must share the same baseId as the assessment's current scorecard. If omitted, the latest active revision is used.

Request Example

{
  "scorecardId": 1
}

Responses

200 — Assessment re-processed successfully

Response Example

{
  "id": 1,
  "scorecardId": 1,
  "scorecardBaseId": 1,
  "state": "aiReady",
  "assessedUser": 42,
  "assessedByUser": 1,
  "ticketId": 12345,
  "worklogId": 1,
  "aiSummary": "Good job overall, scored 85%",
  "totals": {
    "scoredPoints": 24,
    "usedMaxPoints": 32,
    "totalMaxPoints": 47,
    "percentage": 75
  },
  "data": {
    "aiSummary": "string",
    "general": null,
    "aiUsage": null,
    "time": null,
    "customerExperience": null,
    "categories": [
      null
    ],
    "totals": null,
    "supervisorAssessment": "string",
    "assessmentDate": "2026-01-01T12:00:00Z",
    "discussionDate": "2026-01-01T12:00:00Z"
  },
  "createdAt": "2026-01-01T12:00:00Z",
  "modifiedAt": "2026-01-01T12:00:00Z",
  "canEdit": true
}

400 — Assessment is in a state that does not allow re-running AI processing, or the requested scorecard revision belongs to a different scorecard

403 — Unauthorized (no permission to edit this assessment)

404 — Assessment not found

500 — Internal error