curl -i -X POST \
  'https://api.portal.io/public/proposals/123/area/55/option' \
  -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 'ClientDescription=Premium+Installation+Package' \
  -d 'InternalNotes=Use+18-gauge+wire+throughout'

import requests
from portal_auth import sign_request

url = "https://api.portal.io/public/proposals/123/area/55/option"
timestamp = "Mon, 06 Apr 2026 00:22:19 GMT"
content_type = "application/x-www-form-urlencoded"
signature = sign_request("POST", url, content_type, timestamp, "YOUR_USER_KEY", "YOUR_SECRET_KEY")

response = requests.post(url, headers={
    "Accept": "application/json",
    "Content-Type": content_type,
    "X-MSS-API-APPID": "YOUR_APP_ID",
    "X-MSS-API-USERKEY": "YOUR_USER_KEY",
    "X-MSS-CUSTOM-DATE": timestamp,
    "X-MSS-SIGNATURE": signature
}, data={
    "ClientDescription": "Premium Installation Package",
    "InternalNotes": "Use 18-gauge wire throughout"
})
print(response.json())

const { signRequest } = require('./portalAuth');

const url = "https://api.portal.io/public/proposals/123/area/55/option";
const timestamp = new Date().toUTCString();
const contentType = "application/x-www-form-urlencoded";
const signature = signRequest("POST", url, contentType, timestamp, "YOUR_USER_KEY", "YOUR_SECRET_KEY");

const response = await fetch(url, {
    method: "POST",
    headers: {
        "Accept": "application/json",
        "Content-Type": contentType,
        "X-MSS-API-APPID": "YOUR_APP_ID",
        "X-MSS-API-USERKEY": "YOUR_USER_KEY",
        "X-MSS-CUSTOM-DATE": timestamp,
        "X-MSS-SIGNATURE": signature
    },
    body: new URLSearchParams({ ClientDescription: "Premium Installation Package", InternalNotes: "Use 18-gauge wire throughout" })
});
const data = await response.json();
console.log(data);

{
  "id": 123,
  "lastModifiedDate": "2026-04-06T00:22:19Z",
  "areas": [
    {
      "id": 55,
      "name": "Living Room",
      "options": [
        {
          "id": 201,
          "status": "Draft",
          "clientDescription": null,
          "installerDescription": null
        },
        {
          "id": 202,
          "status": "Draft",
          "clientDescription": "Premium Installation Package",
          "installerDescription": "Use 18-gauge wire throughout"
        }
      ]
    }
  ]
}