Recruitment Job Openings API

Summary

Four native operations list, create, update, and change status for job openings.

Audience

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

Reference Content

Method	Relative route	Input or output
GET	/recruitment/job-openings	Array of JobOpeningDto
POST	/recruitment/job-openings	CreateJobOpeningInput to JobOpeningDto
PUT	/recruitment/job-openings/{id}	UpdateJobOpeningInput to JobOpeningDto
PATCH	/recruitment/job-openings/{id}/status	ChangeStatusInput to JobOpeningDto

The public opening query is documented with applications. No native opening-detail, delete, archive, or pagination route is 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/JobOpeningCommands.cs
• microservices/src/recruitment-service/Application/Queries/RecruitmentQueries.cs

Related Articles

• Recruitment API documentation
• Response and error model

See Also

• Recruitment technical documentation
• Recruitment module

Keywords

• Recruitment API
• Source-backed endpoint reference

Revision Information

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