Skip to main content

Recruitment Compatibility Candidates API

Summary​

Compatibility routes cover candidate creation/detail/status/notes/compensation approval plus public application.

Audience​

Developers, QA and support engineers, implementation partners, architects, and security reviewers.

Reference Content​

MethodRelative routePurpose
POST/api/hr-suite/recruitment/public/positions/{positionId}/applyPublic compatibility application
POST/api/hr-suite/recruitment/candidatesAdministrative candidate creation
GET/api/hr-suite/recruitment/candidates/{id}Candidate compatibility record
PATCH/api/hr-suite/recruitment/candidates/{id}/statusStage/status update
POST/api/hr-suite/recruitment/candidates/{id}/notesAdd note
PATCH/api/hr-suite/recruitment/candidates/{id}/ctc-approvalCompensation approval state

Candidate request/response contracts include sensitive field categories; this page intentionally does not reproduce values or personal examples. Compensation authorization and parity are not enforced by the route definition.

Response and Errors​

Successful Result-based operations return direct values. Confirmed failure mappings are 400 validation, 404 missing resource, and 409 conflict with a message object. Direct queries and diagnostics return their source-defined shapes.

Requires confirmation​

Endpoint authorization, production exposure, privacy controls, ownership, operational limits, and compatibility parity require confirmation.

Source References​

  • microservices/src/recruitment-service/Api/RecruitmentCompatEndpoints.cs
  • microservices/src/recruitment-service/Application/Compatibility/CompatContracts.cs
  • microservices/src/recruitment-service/Application/Compatibility/CompatCommands.cs
  • microservices/src/recruitment-service/Application/Compatibility/CompatQueries.cs

See Also​

Keywords​

  • Recruitment API
  • Source-backed endpoint reference

Revision Information​

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