Skip to main content

Recruitment Offers API

Summary​

Offer APIs cover list, creation, revision, internal lifecycle actions, and public token responses.

Audience​

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

Reference Content​

Internal/native lifecycle​

MethodRelative routePurpose
GET/recruitment/offersList OfferDto records
POST/recruitment/offersCreate from CreateOfferInput
POST/recruitment/offers/{id}/reviseRevise from ReviseOfferInput
POST/recruitment/offers/{id}/acceptAccept from AcceptOfferInput
POST/recruitment/offers/{id}/declineDecline with reason
POST/recruitment/offers/{id}/withdrawWithdraw with optional reason
POST/recruitment/offers/{id}/sendMark/send supported offer state

Public response​

MethodRelative routePurpose
GET/recruitment/public/offers/{token}Return PublicOfferDto
POST/recruitment/public/offers/{token}/acceptCandidate acceptance
POST/recruitment/public/offers/{token}/rejectCandidate rejection

Offer values and response examples are intentionally excluded. Token expiry/revocation and public authorization governance 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/Api/RecruitmentPublicEndpoints.cs
  • microservices/src/recruitment-service/Application/Dtos.cs
  • microservices/src/recruitment-service/Application/Commands/OfferCommands.cs

See Also​

Keywords​

  • Recruitment API
  • Source-backed endpoint reference

Revision Information​

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