> ## 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. # Update a quality assessment > Update an assessment including scores, reasons, supervisor notes, and dates. User must have permission to edit this assessment (qualityDoAssessmentsTeam or qualityDoAssessmentsAll). Automatically transitions state from aiReady to reviewOngoing when edits are made. ## OpenAPI ````yaml https://dev.enneo.dev/api/mind/docs/open-api patch /quality/assessment/{id} 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}: patch: tags: - Quality Management summary: Update a quality assessment description: > Update an assessment including scores, reasons, supervisor notes, and dates. User must have permission to edit this assessment (qualityDoAssessmentsTeam or qualityDoAssessmentsAll). Automatically transitions state from aiReady to reviewOngoing when edits are made. operationId: updateQualityAssessment parameters: - name: id in: path required: true description: Assessment ID schema: type: integer requestBody: required: true content: application/json: schema: type: object properties: aiSummary: type: string description: AI-generated summary (editable by supervisors) supervisorAssessment: type: string description: Supervisor's free-form assessment text assessmentDate: type: string format: date-time description: Date when assessment was completed discussionDate: type: string format: date-time description: Date when assessment was discussed with assessee criteria: type: array description: Array of criterion updates items: type: object required: - categoryId - criterionId properties: categoryId: type: integer description: Category identifier from the scorecard definition criterionId: type: integer description: Criterion identifier within the category score: type: number description: Optional updated score reason: type: string description: Optional free-form reason example: - categoryId: 1 criterionId: 2 score: 5 reason: Great intro state: type: string enum: - reviewedBySupervisor - discussedWithAssessee description: Transition to a new state example: aiSummary: Updated AI summary after listening to the call. supervisorAssessment: Focus on clearer closing. assessmentDate: '2024-06-12T11:00:00Z' discussionDate: '2024-06-13T09:00:00Z' criteria: - categoryId: 1 criterionId: 2 score: 5 reason: Great intro - categoryId: 2 criterionId: 6 reason: Added more context for the closing paragraph. state: reviewedBySupervisor responses: '200': description: Assessment updated successfully content: application/json: schema: $ref: '#/components/schemas/QualityAssessment' examples: default: summary: Full assessment after supervisor edit value: id: 901 scorecardId: 42 scorecardBaseId: 17 state: reviewedBySupervisor assessedUser: 23 assessedByUser: 12 ticketId: 8821 worklogId: 551 createdAt: '2024-06-12T10:20:00Z' modifiedAt: '2024-06-12T11:05:00Z' canEdit: true data: aiSummary: Updated AI summary after listening to the call. categories: - categoryId: 1 criteria: - id: 2 score: 5 reason: Great intro state: humanVerified lastEditedByUserId: 12 lastEditedAt: '2024-06-12T10:55:00Z' totals: scoredPoints: 5 usedMaxPoints: 5 totalMaxPoints: 5 percentage: 100 - categoryId: 2 criteria: - id: 6 score: 3 reason: Added more context for the closing paragraph. state: humanVerified lastEditedByUserId: 12 lastEditedAt: '2024-06-12T11:00:00Z' totals: scoredPoints: 15 usedMaxPoints: 17 totalMaxPoints: 20 percentage: 88.2 totals: scoredPoints: 20 usedMaxPoints: 22 totalMaxPoints: 25 percentage: 80 supervisorAssessment: Focus on clearer closing. assessmentDate: '2024-06-12T11:00:00Z' discussionDate: '2024-06-13T09:00:00Z' worklog: userId: 23 worklogId: 551 lastInteraction: '2024-06-12T09:59:00Z' ticketId: 8821 conversationId: 331 action: reply actionList: - reply - internal-note aiUsage: automationLevel: 2 automationLevelLabel: Assisted aiAgents: [] time: duration: 480 durationAfterWork: 120 segments: [] customerExperience: slaMet: true netSecondsClosedAfterSla: -30 closingDateForSLA: '2024-06-12T09:40:00Z' dueDateForSLA: '2024-06-12T10:00:00Z' reOpened: false csat: null '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 ````