/api/applicants/ID/trackers/ID

Use the HEAD verb to test if the applicant in question has this tracker. A request with the GET verb returns some additional information about the tracker (e.g created date, notes etc.).

Note that this will not return the tracker itself, but rather represents the relationships between the applicant and the tracker. Follow the tracker URI in the response to retrieve further information about the tracker in question.

GET /api/applicants/123/trackers/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

Content-Type: application/json
Content-Length: 1234

{
  "assigned": "2014-06-29T18:11:15+00:00",
  "tracker": "/api/applicants/trackers/1"
}

Set a tracker code to the applicant in question. This requires that the tracker already exists. Use POST to create a tracker code first, then this API call will allow you to PUT the tracker (identified by it's code) to any number of applicants.

In other words, this will not create a new tracker, but create a relationship (association) between an existing tracker and an applicant.

PUT /api/applicants/123/trackers/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

Content-Type: text/plain
Content-Length: 0

Remove the tracker from the applicant in question. Note that this does not delete the tracker itself, only removing it's association with the applicant in question.

HEAD /api/applicants/123/trackers/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

Content-Type: text/plain
Content-Length: 0