API Reference

Create Vendor Risk Assessment

post
https://api.scalepad.com/controlmap/v1/clients//vendors//risk-assessments

Creates a one-time Risk Assessment assignment from a client questionnaire and an existing vendor contact.

Create the contact separately; missing or ambiguous contacts are rejected. The assigned contact is notified when the assessment becomes active. Returns the assignment identity and its detail Location. Repeating schedules are not supported.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Client UUID or tenant_id accessible to the API key.

Accepts either the client UUID or the client's tenant_id.

string
required

Vendor code in this client.

Body Params

Creates one Risk Assessment assignment. Create the vendor contact separately first; contact_email resolves only within this vendor.

string
required
length between 1 and 100

Assessment name.

int32
required

Tenant Risk Assessment questionnaire ID from the questionnaire lookup. Quick Assessment questionnaires are not accepted.

string
required
length between 1 and 255

Email of exactly one existing contact belonging to this vendor; matched case-insensitively after trimming. No contact is created implicitly.

date-time
required

Assignment start timestamp with an explicit UTC offset. Its calendar date cannot precede today in time_zone.

date-time
required

Assignment due timestamp with an explicit UTC offset, on or after start_date.

string
length between 1 and 100
Defaults to UTC

IANA time zone used for date-based scheduling. Omit for UTC.

Responses

Updated 1 day ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 1 day ago

Did this page help you?