Added
ControlMap API - Vendor Risk Assessment Lifecycle
October 22nd, 2026
Summary
Discover Risk Assessment questionnaires, create a vendor assignment using an existing contact, update its details, and delete a selected assignment through the API. Existing question-answer and workflow updates remain available. The major version remains v1; existing integrations require no migration.
Changes
New endpoints
Vendor Risk Assessments
-
GET
/controlmap/v1/clients/{client_id}/vendors/questionnaires- N/A → Available
- Type: addition
- Notes: List this client's Risk Assessment questionnaires with cursor pagination. Use a returned
idasquestionnaire_id; Quick Assessment questionnaires are excluded.
-
POST
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/risk-assessments- N/A → Available
- Type: addition
- Notes: Create a one-time assignment with
name,questionnaire_id,contact_email,start_date, andend_date. Create the contact through the vendor contact API first. Email resolution is limited to this vendor and rejects missing or ambiguous matches. The response includesassessment_link_idand a detailLocation. The assigned contact is notified when the assessment becomes active.
-
DELETE
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/risk-assessments/{assessment_link_id}- N/A → Available
- Type: addition
- Notes: Delete the selected assignment and its question relationships. Other assignments and vendor contacts remain. Partner-managed assignments cannot be deleted. Success returns
204with no body; a repeated deletion returns404.
Changed
- PATCH
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/risk-assessments/{assessment_link_id}- Question and workflow updates → Assignment details, question and workflow updates
- Type: addition
- Notes: Optionally update
name,contact_email,start_date, orend_date. Send assignment details separately from question or workflow updates. Omitted fields remain unchanged; explicit metadata nulls are rejected. Reopen completed assignments before changing their details. PATCH continues to return204; use GET to verify the saved state.
Dates
- Effective: [2026-10-21]
