Appraisal Goal API

Summary

Goal mutation as a child operation of the appraisal API.

Audience

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

Overview

There is one canonical goal operation. No independent goal list, detail, update, delete, progress, objective, or KPI route family exists.

Endpoint family

Family	Route	Methods	Contract or purpose
Add goal	/performance/appraisals/{id}/goals	POST	AddGoalInput; updated AppraisalDto

• The source DTO contains description, metric, weight, and an evaluation field; public examples omit content and values.
• The application requires an editable appraisal, validates the title, normalizes bounded inputs, records history, and saves the lifecycle event.
• Missing appraisal returns Not Found; invalid state or input returns Bad Request.

Classification

Implemented child operation; independent goal management is Not implemented.

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

Goal update/delete, progress, ownership, limits, and response redaction require confirmation.

Related Articles

• Performance API documentation
• Performance technical documentation

See Also

• Performance business documentation
• API overview

Keywords

• Performance API
• Goals
• 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/Domain/Appraisal/Appraisal.cs

Revision Information

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