Added

ControlMap API - Vendor Risk Assessment Lifecycle


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 id as questionnaire_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, and end_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 includes assessment_link_id and a detail Location. 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 204 with no body; a repeated deletion returns 404.

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, or end_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 return 204; use GET to verify the saved state.

Dates

  • Effective: [2026-10-21]