Offer comments

Represents the offer letter text/comments for the application offer.

URI
/api/v9/applications/ID/offers/ID/comments

GET Get the offer comments

A request with the GET verb returns the offer letter text (“comments”) for this particular offer (identified by offer ID).

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

Response headers

HeaderValueDescription
Content-Typeapplication/jsonMedia type of the resource
Content-Length1234Size of the response body in bytes

Response codes

Response codeDescription
200 OKThe offer letter text (“comments”) was successfully returned
404 Not FoundThe application does not have this offer

Example response

Response
"Hello\n\nCongratulations, you are now accepted to ...."

PUT Set the offer comments

Set the offer letter text (“comments”) to the application offer (identified by its ID).

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

Raw request body

The request body must contain a valid JSON object. In the JSON structure, you can use either plain text or text formatted using the Textile markup.

Upon successful validation, the provided text is saved as the offer letter text (“comments”) for the application.

Request body
"Hello,\n\nThank you for your application!..."
Request body
"Hello,\n\nThank you for your application!\n\nPlease upload the following documents using the **Tasks** section in the portal:\n\n* Passport copy\n* Transcript copy"

Example request

Request
curl
curl \
  -X PUT \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  -d '"Hello,\n\nThank you for your application!..."' \
  "https://apply.example.edu/api/v9/applications/123/offers/321/comments"
Request
curl
curl \
  -X PUT \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  -d '"Hello,\n\nThank you for your application!\n\nPlease upload the following documents using the **Tasks** section in the portal:\n\n* Passport copy\n* Transcript copy"' \
  "https://apply.example.edu/api/v9/applications/123/offers/321/comments"

Response headers

HeaderValueDescription
Content-Typetext/plainMedia type of the resource
Content-Length0Size of the response body in bytes
Response codeDescription
200 OKThe offer letter text/comments were successfully set
400 Bad RequestInvalid offer letter text/comments
404 Not FoundThe application does not have this offer