Skip to main content
Use this endpoint to set or update the internal installer notes for a specific area option. These notes are intended for the installer team and are not included on customer-facing proposal documents. Like the client description endpoint, the route requires both the proposal ID and area option ID to confirm that the option belongs to the correct proposal before saving the update.

​
Request

POST /public/proposals/{ProposalId}/area-options/{AreaOptionId}/installernotes

​
Headers

​
Accept
string
required
Must be application/json.
​
Content-Type
string
required
Must be application/x-www-form-urlencoded.
​
X-MSS-API-APPID
string
required
Your API Application Key.
​
X-MSS-API-USERKEY
string
required
Your User API Key.
​
X-MSS-CUSTOM-DATE
string
required
Current UTC timestamp in RFC 7231 format.
​
X-MSS-SIGNATURE
string
required
HMAC-SHA256 signature, Base64-encoded.

​
Path Parameters

​
ProposalId
integer
required
The unique ID of the proposal the area option belongs to.
​
AreaOptionId
integer
required
The unique ID of the area option to update.

​
Body

​
InstallerNotes
string
Internal notes for the installer team. These notes do not appear on customer-facing documents. Submit an empty string to clear the notes.

​
Response

​
200 Success

Returns the full updated proposal detail reflecting the new installer notes.
​
id
integer
required
Unique identifier of the proposal.
​
lastModifiedDate
string
ISO 8601 timestamp of the most recent modification.
​
areas
array
All areas on the proposal, with the updated option reflecting the new installerNotes.

​
Error Codes

CodeMeaning
401Not authorized. Invalid or missing HMAC authentication headers.
402Active subscription required.
403You do not have permission for this action.
404Proposal or area option not found.
409Proposal is in a state that does not allow editing.

​
Example

curl -i -X POST \
  'https://api.portal.io/public/proposals/123/area-options/201/installernotes' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'X-MSS-API-APPID: YOUR_APP_ID' \
  -H 'X-MSS-API-USERKEY: YOUR_USER_KEY' \
  -H 'X-MSS-CUSTOM-DATE: Mon, 06 Apr 2026 00:22:19 GMT' \
  -H 'X-MSS-SIGNATURE: BASE64_SIGNATURE' \
  -d 'InstallerNotes=Use+18-gauge+wire+on+all+runs.+Check+panel+capacity+before+install.'

{
  "id": 123,
  "lastModifiedDate": "2026-04-06T00:22:19Z",
  "areas": [
    {
      "id": 55,
      "name": "Living Room",
      "options": [
        {
          "id": 201,
          "status": "Draft",
          "clientDescription": "Standard Installation Package",
          "installerNotes": "Use 18-gauge wire on all runs. Check panel capacity before install."
        }
      ]
    }
  ]
}