Priority
API version
Select a version to change the base URI
in syntax and code examples. Learn about versions:
in syntax and code examples. Learn about versions
Represents the applicant’s preference order for a course in an application.
URI
/api/v9/applications/ID/courses/ID/priorityGET Get the course priority
Get the priority level of a specific course in an application.
A value of 1 indicates the highest priority. Higher numerical values indicate lower priorities.
Syntax
GET /api/v9/applications/123/courses/1/priority
Host: apply.example.edu
Authorization: DREAM apikey="..."Example request
Request
curl
curl \
-X GET \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
"https://apply.example.edu/api/v9/applications/123/courses/1/priority"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | application/json | Media type of the resource |
Content-Length | 1234 | Size of the response body in bytes |
| Response code | Description |
|---|---|
200 OK | The priority data was successfully returned |
404 Not Found | The application does not have this course |
Example response
Response
1PUT Set the course priority
Sets the priority level for a course added to the application.
When a priority is updated, the API automatically reorders existing priorities to maintain a valid sequence.
Syntax
PUT /api/v9/applications/123/courses/1/priority
Host: apply.example.edu
Authorization: DREAM apikey="..."Raw request body
Provide the new priority value as a single integer in the request body.
Request body
1Example request
Request
curl
curl \
-X PUT \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
-d '1' \
"https://apply.example.edu/api/v9/applications/123/courses/1/priority"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | text/plain | Media type of the resource |
Content-Length | 0 | Size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
204 No Content | The priority was successfully changed |
404 Not Found | The application does not have this course |
400 Bad Request | The priority value failed validation, see the error description |