> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enneo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Re-run AI processing for a quality assessment

> 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.




## OpenAPI

````yaml https://dev.enneo.dev/api/mind/docs/open-api post /quality/assessment/{id}/refresh
openapi: 3.0.0
info:
  version: '1'
  title: enneo.MIND API
  description: This describes the API of enneo Mind, the main ticketing backend
  contact:
    name: enneo GmbH
    email: richard@enneo.ai
  license:
    name: Proprietary software
    url: https://enneo.ai
servers:
  - url: https://demo.enneo.ai/api/mind
    description: Production server, demo client
  - url: https://main.enneo.dev/api/mind
    description: Development main branch
  - url: http://localhost:8005/api/mind
    description: Local development server
security:
  - bearerAuth:
      - api
  - cookieAuth:
      - api
paths:
  /quality/assessment/{id}/refresh:
    post:
      tags:
        - Quality Management
      summary: Re-run AI processing for a quality assessment
      description: >
        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.
      operationId: refreshQualityAssessment
      parameters:
        - name: id
          in: path
          required: true
          description: Assessment ID
          schema:
            type: integer
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                scorecardId:
                  type: integer
                  description: >
                    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.
            example:
              scorecardId: 42
      responses:
        '200':
          description: Assessment re-processed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QualityAssessment'
        '400':
          description: >-
            Assessment is in a state that does not allow re-running AI
            processing, or the requested scorecard revision belongs to a
            different scorecard
        '403':
          description: Unauthorized (no permission to edit this assessment)
        '404':
          description: Assessment not found
        '500':
          description: Internal error
components:
  schemas:
    QualityAssessment:
      type: object
      description: Quality assessment of agent performance on a specific work session
      properties:
        id:
          type: integer
          description: Assessment ID
          example: 1
        scorecardId:
          type: integer
          description: ID of the scorecard used
          example: 1
        scorecardBaseId:
          type: integer
          description: Base ID of the scorecard used
          example: 1
        state:
          type: string
          enum:
            - unprocessed
            - aiInProgress
            - aiReady
            - reviewOngoing
            - reviewedBySupervisor
            - discussedWithAssessee
            - error
            - deleted
          description: Assessment workflow state
          example: aiReady
        assessedUser:
          type: integer
          description: ID of the assessed user (agent)
          example: 42
        assessedByUser:
          type: integer
          nullable: true
          description: ID of the supervisor who assessed
        ticketId:
          type: integer
          description: Related ticket ID
          example: 12345
        worklogId:
          type: integer
          nullable: true
          description: Related worklog ID
        aiSummary:
          type: string
          description: AI-generated summary (summary format)
          example: Good job overall, scored 85%
        totals:
          type: object
          description: Score totals
          properties:
            scoredPoints:
              type: integer
              description: Points achieved
              example: 24
            usedMaxPoints:
              type: integer
              description: Maximum points for scored criteria
              example: 32
            totalMaxPoints:
              type: integer
              description: Maximum points for all criteria
              example: 47
            percentage:
              type: number
              description: Percentage score
              example: 75
        data:
          type: object
          description: Full assessment data (full format only)
          properties:
            aiSummary:
              type: string
            general:
              type: object
              description: Work session metadata
              additionalProperties: true
            aiUsage:
              type: object
              description: AI automation metrics
              additionalProperties: true
            time:
              type: object
              description: Time tracking information
              additionalProperties: true
            customerExperience:
              type: object
              description: Customer satisfaction metrics
              additionalProperties: true
            categories:
              type: array
              description: Scored categories and criteria
              items:
                type: object
                additionalProperties: true
            totals:
              type: object
              additionalProperties: true
            supervisorAssessment:
              type: string
              nullable: true
            assessmentDate:
              type: string
              format: date-time
              nullable: true
            discussionDate:
              type: string
              format: date-time
              nullable: true
        createdAt:
          type: string
          format: date-time
        modifiedAt:
          type: string
          format: date-time
        canEdit:
          type: boolean
          description: Whether current user can edit this assessment
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT-based authentication
      x-scopes:
        api: Full access to the API
    cookieAuth:
      type: apiKey
      in: cookie
      name: connect.sid
      description: Cookie-based authentication
      x-scopes:
        api: Full access to the API

````