Opt into one add-on (portal session only)

POST

/broker/submissions/{submission_id}/application-workspace/add-ons

const url = 'https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/application-workspace/add-ons';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"program_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/application-workspace/add-ons \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "program_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

Opts into one add-on listed in the workspace’s preparation.add_ons (cover that rides beside the requested lines, such as a parametric power-outage product). An add-on is never prepared on its own; choosing it prepares its application. Idempotent. Portal-session only by design: a connected app or machine token answers 403.

Authorizations

brokerOAuth

Parameters

Path Parameters

submission_id

required

string format: uuid

Request Body^required

application/json

object

program_id

required

string format: uuid

Example^generated

{
  "program_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

200

The add-ons chosen on this submission

403

Requires an unrestricted broker portal session

404

Submission not found (or not your brokerage’s)

422

The add-on isn’t offered on this submission