Differences

This shows you the differences between two versions of the page.

--- api:api_applications_id_flags_id [2014/07/11 09:30] – [HEAD, GET] Lauri Elevant
+++ api:api_applications_id_flags_id [2014/07/17 10:32] – Lauri Elevant
@@ Line 4: / Line 4: @@
 ===== HEAD, GET =====
-Use the ''HEAD'' verb to test if the application in question has this flag set (identified by the flag's ID). A request with the ''GET'' verb returns some additional information about the flag ( FIXME ).
+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.
@@ Line 21: / Line 23: @@
 | ''200 OK'' | The flag is set |
-| ''404 Not Found'' | The flag was not set |
+| ''404 Not Found'' | The flag does not exist |
+| ''404 Not Found'' | The flag was not set to this application |
 ===== PUT =====
-Set the flag (identified by it's ID) to the application in question.
+Set a flag (identified by it's ID) to the application in question.  **This requires that the flag already exists.** Use ''POST'' [[api:api_applications_flags|/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.
 ==== Syntax ====
@@ Line 42: / Line 47: @@
 | ''200 OK'' | Flag was successfully set |
+| ''404 Not Found'' | The flag does not exist |
 ===== 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 ====
@@ Line 62: / Line 70: @@
 | ''204 No Content'' | Flag was successfully deleted |
+| ''404 Not Found'' | The flag does not exist |
+| ''404 Not Found'' | The flag was not set to this application |