/api/applications/ID/flags/ID

Use the HEAD verb to test if the application in question has this flag. A request with the GET verb returns some additional information about the flag association (date assigned etc.).

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

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

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

{
  "assigned": "2014-07-11T09:24:51+00:00",
  "flag": "/api/applications/flags/6"
}

Set a flag (identified by it's ID) to the application in question. This requires that the flag already exists. Use POST /api/applications/flags to create a flag first, then this API call will allow you to PUT the flag (identified by it's code) to any number of applications.

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

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

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

Remove the flag (identified by it's ID) from the application in question.

Note that this does not delete the flag itself, only removing it's association with the application in question.

DELETE /api/application/123/flags/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

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