This is an old revision of the document!
/api/applications/ID/tasks
HEAD, GET
List all tasks that have been generated for the application in question. Use the HEAD
verb to see if there are any tasks yet. The X-Count
header will indicate the number of tasks.
Tasks are created automatically for each application by the Business Rules Engine, depending on the rules set up for each client. The tasks can be completely customized in their title, description (e.g instructions) and available statuses for the applicant to pick.
This subsystem of DreamApply will see some internal changes in the near future, hence only the critical functionalities have been exposed by the API in order to avoid possible back-compat breaks in otherwise non-critical areas. Namely - the class (type of task) and status name are exposed, along with some other metadata. These should provide for most use cases.
In the future, also the status descriptions will be exposed - titles, instructions, information about reminders etc.
Syntax
GET /api/applications/123/tasks Host: apply.example.edu Authorization: DREAM apikey="..."
Response headers
Content-Type: application/json Content-Length: 1234 X-Count: 4
Response example
{ "1": { "created": "2015-07-27T15:36:36+00:00", "reminded": null, "committed": "2015-07-27T17:36:36+00:00", "resolved": "2015-07-27T17:36:36+00:00", "class": "checklist-language-english", "status": "I have received my language test score", "notes": { "applicant": null, "administrator": "Seems to be good!" } }, "5": { "created": "2015-07-27T15:36:36+00:00", "reminded": "2015-07-31T15:36:36+00:00", "committed": null, "resolved": null, "class": "checklist-passport", "status": "I have NOT yet attached my passport/ID card", "notes": { "applicant": "I need help", "administrator": null } } }