Skip to main content

Recruitment Onboarding API

Summary​

Four native operations list onboarding, create handoffs, update status, and join candidates.

Audience​

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

Reference Content​

MethodRelative routePurpose
GET/recruitment/onboardingList OnboardingDto
POST/recruitment/offers/{id}/move-to-onboardingCreate/reuse onboarding from accepted offer
PATCH/recruitment/onboarding/{id}/statusApply OnboardingStatusInput
POST/recruitment/candidates/{id}/joinComplete candidate joining

Completion synchronously provisions an Employee before committing Recruitment completion. The Employee Service call is not an exposed Recruitment endpoint. Login provisioning, manager mapping, distributed rollback, and reconciliation are not implemented.

Response and Errors​

Successful Result-based operations return their DTO directly. Confirmed failures map to 400 validation, 404 missing resource, or 409 conflict with a message object. Authorization-specific outcomes are not defined by these endpoints.

Requires confirmation​

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

Source References​

  • microservices/src/recruitment-service/Api/RecruitmentEndpoints.cs
  • microservices/src/recruitment-service/Application/Dtos.cs
  • microservices/src/recruitment-service/Application/Commands/OnboardingCommands.cs
  • microservices/src/recruitment-service/Application/Commands/OfferCommands.cs
  • microservices/src/recruitment-service/Infrastructure/EmployeeServiceClient.cs

See Also​

Keywords​

  • Recruitment API
  • Source-backed endpoint reference

Revision Information​

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