Offer comments
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 offer letter text/comments for the application offer.
URI
/api/v9/applications/ID/offers/ID/commentsGET 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
| Header | Value | Description |
|---|---|---|
Content-Type | application/json | Media type of the resource |
Content-Length | 1234 | Size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
200 OK | The offer letter text (“comments”) was successfully returned |
404 Not Found | The 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
| Header | Value | Description |
|---|---|---|
Content-Type | text/plain | Media type of the resource |
Content-Length | 0 | Size of the response body in bytes |
| Response code | Description |
|---|---|
200 OK | The offer letter text/comments were successfully set |
400 Bad Request | Invalid offer letter text/comments |
404 Not Found | The application does not have this offer |