This is an old revision of the document!


/api/applications/ID/flags/ID

HEAD, GET

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.

Syntax

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

Response headers

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

Response codes

200 OK The flag is set
404 Not Found The flag was not set

PUT

Set the flag (identified by it's ID) to the application in question.

Syntax

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

Response headers

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

Response codes

200 OK Flag was successfully set

DELETE

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.

Syntax

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

Response headers

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

Response codes

204 No Content Flag was successfully deleted