Differences

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

--- api:api_applications_id_flags_id [2014/07/11 09:32] – [HEAD, GET] Lauri
+++ api:api_applications_id_flags_id [2024/07/30 11:50] (current) – external edit 127.0.0.1
@@ Line 14: / Line 14: @@
   Host: apply.example.edu
   Authorization: DREAM apikey="..."
 ==== Response headers ====
@@ Line 19: / Line 20: @@
   Content-Type: application/json
   Content-Length: 1234
 ==== Response codes ====
 | ''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 |
+==== Response example ====
+  {
+    "assigned": "2014-07-11T09:24:51+00:00",
+    "flag": "/api/applications/flags/6"
+  }
 ===== 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 44: / Line 56: @@
 | ''200 OK'' | Flag was successfully set |
+| ''404 Not Found'' | The flag does not exist |
 ===== DELETE =====
@@ Line 67: / Line 79: @@
 | ''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 |