Skip to main content

Recruitment Workflow Callback API

Summary​

One callback operation applies terminal Workflow decisions to requisitions.

Audience​

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

Reference Content​

MethodRelative routeInput
POST/recruitment/workflow/callbackRecruitmentWorkflowCallbackRequest

Duplicate terminal callbacks are handled idempotently by command behavior. The route remains mapped regardless of the Workflow feature flag. Callback authentication, replay protection, and authorization 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/WorkflowIntegration.cs
  • microservices/src/recruitment-service/Application/Commands/RequisitionCommands.cs
  • microservices/src/recruitment-service/Infrastructure/WorkflowServiceClient.cs

See Also​

Keywords​

  • Recruitment API
  • Source-backed endpoint reference

Revision Information​

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