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 Smirnov
+++ api:api_scoresheets_id_scores [2021/08/31 14:26] – Lauri Elevant
@@ 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 |