Offer comments

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

URI
/api/v10/applications/ID/offers/ID/comments

GET Get the offer comments

Retrieve the text/comments for an offer letter.

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

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 text 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 text/comments for an offer letter.

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

Raw request body

The request body must contain a valid JSON object. 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 offer.

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/v10/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/v10/applications/123/offers/321/comments"

Response headers

HeaderValueDescription
Content-Typetext/plainThe media type of the resource
Content-Length0The size 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