more documentation of API endpoint /jobs