code: @POST
  	@Produces(MediaType.APPLICATION_JSON)
  	@Consumes(MediaType.APPLICATION_JSON)
  	@Description("Creates a dashboard.")
  	public DashboardDto createDashboard(@Context HttpServletRequest req, DashboardDto dashboardDto) {
  		if (dashboardDto == null) {
  			throw new WebApplicationException("Null dashboard object cannot be created.", Status.BAD_REQUEST);
  		}
  
  		PrincipalUser owner = validateAndGetOwner(req, dashboardDto.getOwnerName());
  		Dashboard dashboard = new Dashboard(getRemoteUser(req), dashboardDto.getName(), owner);
  
  		copyProperties(dashboard, dashboardDto);
  		return DashboardDto.transformToDto(dService.updateDashboard(dashboard));
  	}
docs: Creates a dashboard.
  
  @param   req           The HTTP request.
  @param   dashboardDto  The dashboard to create.
  
  @return  The corresponding updated DTO for the created dashboard.
  
  @throws  WebApplicationException  If an error occurs.