Appraisal API

Summary

Native appraisal list, detail, creation, and lifecycle-action operations.

Audience

API consumers, engineers, architects, QA, support, security reviewers, implementation partners, and product owners.

Overview

The appraisal family combines reads, creation, goal mutation, review-stage actions, approval, and reopening.

Endpoint family

Family	Route	Methods	Contract or purpose
List	/performance/appraisals	GET	Optional status, cycle, user, and labor filters
Detail	/performance/appraisals/{id}	GET	AppraisalDto
Create	/performance/appraisals	POST	CreateAppraisalInput; Created AppraisalDto
Goal	/performance/appraisals/{id}/goals	POST	AddGoalInput
Self stage	/performance/appraisals/{id}/submit-self-review	POST	SubmitSelfReviewInput
Manager stage	/performance/appraisals/{id}/manager-review	POST	ManagerReviewInput
HR stage	/performance/appraisals/{id}/hr-review	POST	HrReviewInput
Approve	/performance/appraisals/{id}/approve	POST	Optional ApproveAppraisalInput
Reopen	/performance/appraisals/{id}/reopen	POST	Optional ReopenAppraisalInput

• Sensitive evaluation and free-text fields are intentionally not reproduced in examples.
• Responses use AppraisalDto with nested goal and review collections.
• Missing resources map to Not Found, state violations to Bad Request, and Workflow-owned direct decisions to Conflict.

Classification

Implemented canonical family with Transitional Workflow ownership and missing endpoint authorization.

Authentication and authorization

Bearer authentication and tenant context are registered. No Performance endpoint in this family declares an authorization requirement unless explicitly stated above.

Requires confirmation

Subject ownership, reviewer permissions, response redaction, pagination, and direct-access policy require confirmation.

Diagram

Related Articles

• Performance API documentation
• Performance technical documentation

See Also

• Performance business documentation
• API overview

Keywords

• Performance API
• Appraisals
• Draft API documentation

Source References

• microservices/src/performance-service/Api/PerformanceEndpoints.cs
• microservices/src/performance-service/Application/Dtos.cs
• microservices/src/performance-service/Application/Commands/AppraisalCommands.cs
• microservices/src/performance-service/Application/Queries/PerformanceQueries.cs

Revision Information

• Status: Draft
• Last reviewed: 2026-07-16
• Review cycle: Quarterly