Review Cycle API

Summary

List, create, open, and close operations for review cycles.

Audience

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

Overview

The review-cycle family contains four native operations.

Endpoint family

Family	Route	Methods	Contract or purpose
List	/performance/cycles	GET	Optional textual status filter; ReviewCycleDto array
Create	/performance/cycles	POST	CreateCycleInput; Created ReviewCycleDto
Open	/performance/cycles/{id}/open	POST	Updated ReviewCycleDto
Close	/performance/cycles/{id}/close	POST	Updated ReviewCycleDto

• CreateCycleInput carries optional name, period boundaries, and notes.
• Creation validates tenant context, period ordering, and text limits.
• Missing cycles return Not Found; invalid transitions return Bad Request.
• An unrecognized list status is ignored rather than rejected.

Classification

Implemented native family; endpoint authorization remains 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

Cycle permissions, phase advancement, pagination, unknown-filter behavior, and close cascade require confirmation.

Diagram

Related Articles

• Performance API documentation
• Performance technical documentation

See Also

• Performance business documentation
• API overview

Keywords

• Performance API
• Review Cycles
• 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/ReviewCycleCommands.cs
• microservices/src/performance-service/Application/Queries/PerformanceQueries.cs

Revision Information

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