Priority

Represents the applicant’s preference order for a course in an application.

URI
/api/v9/applications/ID/courses/ID/priority

GET 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

HeaderValueDescription
Content-Typeapplication/jsonMedia type of the resource
Content-Length1234Size of the response body in bytes
Response codeDescription
200 OKThe priority data was successfully returned
404 Not FoundThe application does not have this course

Example response

Response
1

PUT 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
1

Example 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

HeaderValueDescription
Content-Typetext/plainMedia type of the resource
Content-Length0Size of the response body in bytes

Response codes

Response codeDescription
204 No ContentThe priority was successfully changed
404 Not FoundThe application does not have this course
400 Bad RequestThe priority value failed validation,
see the error description