Differences

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

--- api:api_applicants_id_notes [2025/03/28 22:09] – Lauri
+++ api:api_applicants_id_notes [2025/05/26 13:31] (current) – Lauri
@@ Line 24: / Line 24: @@
 ==== 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"
-===== PATCH =====
+===== POST =====
-Append some text to existing applicant notes, preserving what is already there.
+Create a new applicant note
 ==== Syntax ====
-  PATCH /api/applicants/123/notes
+  POST /api/applicants/123/notes
   Host: apply.example.edu
   Authorization: DREAM apikey="..."
+==== Parameters ====
+^ 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] |
+  * // Note [1]: If both ''colour'' and ''color'' are specified, then ''colour'' is preferred.//
 ==== Raw request body ====