Skip to main content

Offer Acceptance API Operations

Summary​

Verified acceptance boundaries include an internal native accept command, public-link read/accept/reject operations, portal-shaped compatibility public offer operations, compatibility status update, and move-to-onboarding. Exact routes are centralized in the endpoint catalog.

Audience​

Developers, QA, support, security reviewers, and solution architects.

Acceptance flow​

Native behavior​

Internal and public acceptance are idempotent for an already accepted offer. Acceptance rejects terminal rejected/declined/withdrawn states as conflicts, records audit/timeline evidence, updates candidate stage, and persists domain events. Public rejection requires a reason, is idempotent for an already rejected offer, and conflicts with an accepted offer.

Compatibility behavior​

The compatibility public sign operation translates to extracted acceptance when routed to Recruitment. The monolith sign operation accepts the offer, advances the candidate, closes the position, and creates onboarding if absent. Compatibility response shape is preserved, but internal side effects differ.

The compatibility offer-status operation can change status through path-specific normalization and rules. It is not equivalent to the native acceptance command in all implementations.

Public offer actions explicitly allow anonymous use or are mapped without authentication. Entity lookup by the capability link determines tenant and offer. Expiry or revocation enforcement was not found in the inspected acceptance path.

Requires confirmation​

  • Link expiry, revocation, replay, and rate-limit policy.
  • Whether compatibility status update may set Accepted in production workflows.
  • Exact side-effect parity required before extracted cutover.
  • Whether acceptance must automatically create onboarding on every API family.

Source References​

  • microservices/src/recruitment-service/Api/RecruitmentEndpoints.cs
  • microservices/src/recruitment-service/Api/RecruitmentPublicEndpoints.cs
  • microservices/src/recruitment-service/Api/RecruitmentCompatEndpoints.cs
  • microservices/src/recruitment-service/Application/Commands/OfferCommands.cs
  • microservices/src/recruitment-service/Application/Compatibility/CompatCommands.cs
  • Controllers/RecruitmentController.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/HrSuitePage.tsx

See Also​

Keywords​

  • Public offer acceptance
  • Idempotence
  • Capability link

Revision Information​

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