@DELETE @Path("/{id}") @Produces({MediaType.APPLICATION_JSON, "text/uri-list"}) @ApiOperation( value = "Deletes a particular Feature resource.", notes = "Deletes a Feature of a given ID. The method is idempondent, that is, it can be used more than once without " + "triggering an exception/error. If the Feature does not exist, the method will return without errors. " + "Authentication and authorization requirements apply, so clients that are not authenticated with a " + "valid token or do not have sufficient priviledges will not be able to delete a Feature using this method.") @ApiResponses( value = { @ApiResponse(code = 200, message = "Feature entry was deleted successfully."), @ApiResponse(code = 401, message = "You are not authorized to delete this resource"), @ApiResponse( code = 403, message = "This request is forbidden (e.g., no authentication token is provided)"), @ApiResponse(code = 500, message = "Internal server error - this request cannot be served.") }) public Response deleteFeature( @ApiParam("Clients need to authenticate in order to create resources on the server") @HeaderParam("subjectid") String subjectId, @ApiParam(value = "ID of the Model.", required = true) @PathParam("id") String id) { featureHandler.remove(new Feature(id)); return Response.ok().build(); }