Offer subject

Represents the subject line of an application offer.

URI
/api/v10/applications/ID/offers/ID/subject

GET Get the offer subject

Retrieve the subject line of an offer letter.

Syntax
GET /api/v10/applications/123/offers/321/subject
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/v10/applications/123/offers/321/subject"

Response headers

HeaderValueDescription
Content-Typeapplication/jsonThe media type of the resource
Content-Length1234The size of the response body in bytes

Response codes

Response codeDescription
200 OKThe offer letter subject line was successfully returned
404 Not FoundThe application does not have this offer

Example response

Response
"You are accepted to a study place"

PUT Set the offer subject

Set the subject line for an offer letter.

Syntax
PUT /api/v10/applications/123/offers/321/subject
Host: apply.example.edu
Authorization: DREAM apikey="..."

Raw request body

The request body must contain a valid JSON string literal enclosed in double quotes. Upon successful validation, the provided text is saved as the subject line for the application offer.

Request body
"Congratulations, you are accepted"

Example request

Request
curl
curl \
  -X PUT \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  -d '"Congratulations, you are accepted"' \
  "https://apply.example.edu/api/v10/applications/123/offers/321/subject"

Response headers

HeaderValueDescription
Content-Typetext/plainThe media type of the resource
Content-Length0The size of the response body in bytes
Response codeDescription
200 OKThe subject was successfully set
400 Bad RequestAn invalid offer subject line
404 Not FoundThe application does not have this offer