ControlMap API - Vendor contract clarifications
Summary
Risk Assessment creation returns a public assignment detail location, and assessment contact emails are trimmed before validation. Vendor error examples and update guidance clarify the existing request and permission rules. The major version remains v1.
Changes
Changed
-
POST
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/risk-assessments- Available → Improved
- Type: improvement
- Notes: The
201response documents a requiredLocationheader using the public assignment detail path. Follow it to retrieve the assignment. Contact emails are trimmed before validation; empty names and emails remain invalid. Not-found examples identify the vendor rather than an assignment that has not been created.
-
PATCH
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/risk-assessments/{assessment_link_id}- Available → Improved
- Type: improvement
- Notes: Contact emails are trimmed before validation. Send metadata, question changes and workflow changes separately. A workflow update may include
question_code, which is validated when supplied. Invalid answer errors identify the supplied answer label or code. Success remains204; use GET for readback.
-
GET
/controlmap/v1/clients/{client_id}/vendors/questionnaires- Available → Improved
- Type: improvement
- Notes: Error descriptions distinguish client or role denial from missing account or user mappings. They no longer refer to an assignment identifier, which this lookup does not accept.
-
DELETE
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/risk-assessments/{assessment_link_id}- Available → Improved
- Type: improvement
- Notes: The
400example describes an invalid assignment identifier rather than date validation. Success remains204with no body; a missing or already deleted assignment returns404.
-
GET
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/risk-assessments; GET/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/quick-assessment- Available → Improved
- Type: improvement
- Notes: Filter guidance now describes the existing behavior accurately:
completedselects completed workflow status, whileactive,futureandoverduegroup incomplete assignments by their dates.expiredremains an alias foroverdue.
-
GET and PATCH
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/quick-assessment/{assessment_link_id}- Available → Improved
- Type: improvement
- Notes: Returned answer IDs are informational. PATCH accepts
question_code, an answer label and optional notes; empty answers remain invalid. The invalid-answer400example namesanswer, matching the field accepted by this operation.
-
DELETE
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}- Available → Improved
- Type: improvement
- Notes: Documentation clarifies the existing restriction: vendors with source
PARTNERcannot be deleted, regardless of tech-stack activity or archived products. Changing their status to Inactive does not remove the restriction.
-
POST
/controlmap/v1/clients/{client_id}/vendors/{vendor_code}/documents- Available → Improved
- Type: improvement
- Notes: Multipart upload documentation includes the existing
413response withPAYLOAD_TOO_LARGEwhen the server upload limit is exceeded. Use the signed upload flow for larger files.
Dates
- Effective: [2026-10-22]
