Differences

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

--- api:api_scoresheets_id_scores [2019/03/27 10:13] – [Response example] Anton
+++ api:api_scoresheets_id_scores [2024/07/30 11:50] (current) – external edit 127.0.0.1
@@ Line 24: / Line 24: @@
 ==== Response example ====
-<code javascript>
+<code>
 {
     "1": {
@@ Line 63: / Line 63: @@
 }
 </code>
+===== POST =====
+Append an application to the scoresheet in question. If the application is already on this scoresheet, it will just update the score (and optionally, the comments).
+==== Syntax ====
+  POST /api/scoresheets/123/scores
+  Host: apply.example.edu
+  Authorization: DREAM apikey="..."
+==== Parameters ====
+^ Name ^  ^ Description ^
+| ''application'' | **Required** | An application ID to add |
+| ''points'' | **Required** | The points to set for this scoresheet score. Validation depends on the scoresheet settings. In case of a mapped-type value, it takes the numeric equivalent. |
+| ''comments'' | Optional | Up to 512 characters of comments. May be omitted or left empty in which case it has no effect (including leaving any existing comments in place). |
+==== Response headers ====
+  Content-Type: application/json
+  Content-Length: 0
+==== Response codes ====
+| ''201 Created'' | New applicant/lead was created |