Differences

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

--- api:api_applications_id_offers_id_notes [2024/07/30 11:50] – external edit 127.0.0.1
+++ api:api_applications_id_offers_id_notes [2025/05/26 13:32] (current) – Lauri
@@ Line 25: / Line 25: @@
 ==== Response example ====
+== API version >= 6 ==
+  {
+    "1": {
+        "created": "1970-01-01T00:00:01+00:00",
+        "removed": null,
+        "colour": "Yellow",
+        "pinned": false,
+        "collapsed": false,
+        "Notes": "Some comments",
+    },
+    "2": {
+        "created": "1970-01-01T00:00:01+00:00",
+        "removed": null,
+        "colour": "Salmon",
+        "pinned": true,
+        "collapsed": false,
+        "Notes": "Some other comments",
+    },
+  }
+== API version  < 6 ==
   "Some comments"
-===== PUT =====
+===== POST =====
-Set the notes to some text, overwriting the existing notes.
+Create a new offer note.
 ==== Syntax ====
-  PUT /api/applications/123/offers/321/notes
+  POST /api/applications/123/offers/321/notes
   Host: apply.example.edu
   Authorization: DREAM apikey="..."
-==== Raw request body ====
+==== Parameters ====
-Note that the comments have to be a proper JSON string token. In a JSON string only space is allowed per the specification, newlines, for example, have to be encoded.
+^ Name ^  ^ Description ^ Notes ^
+| ''colour'' | Optional | Specify the colour of the (sticky) note: ''Yellow'', ''Orange'', ''Salmon'', ''Green'', ''Blue'', ''Violet'' | |
+| ''color'' | Optional | An alias for ''colour'' | [1] |
-  "Some notes\nAnother line"
+  * // Note [1]: If both ''colour'' and ''color'' are specified, then ''colour'' is preferred.//
-==== Response headers ====
-  Content-Type: text/plain
-  Content-Length: 0
-==== Response codes ====
-| ''204 No Content'' | The notes were saved |
-| ''400 Bad Request'' | Invalid notes. Please make sure that status is a valid JSON string with quotes. |
-| ''404 Not Found'' | Application does not have this offer |
-===== PATCH =====
-Append some text to existing offer notes, preserving what is already there.
-==== Syntax ====
-  PATCH /api/applications/123/offers/321/notes
-  Host: apply.example.edu
-  Authorization: DREAM apikey="..."
 ==== Raw request body ====