@BasePath /api/v1 @Router /openings [post] @Summary Create Opening @Description Create a new job opening @Tags Openings @Accept json @Produce json @Param request body CreateOpening true "Reques body" @Success 201 {object} OpeningJSONReponse @Failure 400 {object} ErrorResponse.

@BasePath /api/v1 @Router /openings/{id} [delete] @Summary Delete Opening @Description Delete job opening @Tags Openings @Accept json @Produce json @Param id path string true "Opening ID" @Success 204 @Failure 404 {object} ErrorResponse @Failure 500 {object} ErrorResponse.

@BasePath /api/v1 @Router /openings/{id} [get] @Summary Opening Details @Description get job opening details @Tags Openings @Accept json @Produce json @Param id path string true "Opening ID" @Success 200 {object} OpeningJSONReponse @Failure 404 {object} ErrorResponse.

@BasePath /api/v1 @Router /openings [get] @Summary All Job Opening @Description get all job opening @Tags Openings @Accept json @Produce json @Success 200 {object} AllOpeningsJSONReponse @Failure 500 {object} ErrorResponse.

@BasePath /api/v1 @Router /openings/{id} [put] @Summary Update Opening @Description Update a job opening @Tags Openings @Accept json @Produce json @Param request body UpdateOpening true "Reques body" @Param id path string true "Opening ID" @Success 204 @Failure 400 {object} ErrorResponse @Failure 404 {object} ErrorResponse' @Failure 500 {object} ErrorResponse'.