Appraisal Review APIs
Summary
Self, manager, HR, approval, and reopening action endpoints.
Audience
API consumers, engineers, architects, QA, support, security reviewers, implementation partners, and product owners.
Overview
Review actions are commands on an appraisal rather than standalone review resources.
Endpoint family
| Family | Route | Methods | Contract or purpose |
|---|---|---|---|
| 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 review fields and appraisal content are not reproduced.
- All operations return an updated AppraisalDto.
- Direct manager, HR, and approval return Conflict while Workflow-managed.
- No standalone review CRUD, peer review, meeting, competency, or calibration resource exists.
Classification
Implemented staged actions with Transitional Workflow delegation.
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
Action authorization, reviewer ownership, free-text handling, approval separation, and replay policy require confirmation.
Related Articles
See Also
Keywords
- Performance API
- Reviews
- Draft API documentation
Source References
microservices/src/performance-service/Api/PerformanceEndpoints.csmicroservices/src/performance-service/Application/Dtos.csmicroservices/src/performance-service/Application/Commands/AppraisalCommands.csmicroservices/src/performance-service/Domain/Appraisal/Appraisal.cs
Revision Information
- Status: Draft
- Last reviewed: 2026-07-16
- Review cycle: Quarterly