Docs

Getting started

Set up your programme, import vendors, make the first request and review the first vendor. The full API reference and administrator guide come with your workspace.

1. Set up the programme

In Settings, name the owner and SLA of each review lane (security, privacy, legal, finance, IT, business owner), the reassessment cadence for each tier, and the insurance minimums. Add routing rules — when a field matches, add lane, set tier, require document or skip lane — or start with the workflow templates.

2. Bring in what you have

Add vendors and contracts in the console or through the API, then upload the documents you already hold: SOC reports, ISO certificates, pen tests, insurance certificates, DPAs and MSAs. The Document agent reads each one; the Risk agent scores every vendor; the contracts fill the renewal calendar.

3. Make a request

# the console, or the API
curl -s -H "Authorization: Bearer $TOKEN" -H 'content-type: application/json' \
  -d '{"text": "We want Gong for sales call recording, about 40 seats, roughly $60k a year"}' \
  https://app.insightvendors.com/api/requests/intake      # a preview: nothing saved
# → vendor, category, data types, spend, duplicates, questions it could not answer

4. Review and decide

Reviewers see their lane on the request: the findings with pages, the score with reasons, the contract deviations and the routing reasons. Approve, approve with conditions, reject or send back. Release the assessment invitation from the Outbox; the vendor answers in the portal.

5. Set the dial

In Agents, start most agents at L2 (ask first). Raise one when its acceptance rate shows it is right.

API

The same API the console uses

All endpoints are under /api and take a bearer token from your identity provider.

AreaEndpoints
RequestsPOST /requests/intake (preview) · POST /requests · GET /requests · lane decisions
VendorsGET /vendors · GET /vendors/{id} (360) · research and re-score
DocumentsPOST /documents (file or text) · GET /documents/{id} · POST /documents/{id}/analyze
AssessmentsPOST /assessments · POST /assessments/{id}/send · POST /assessments/{id}/review · portal /public/portal/{token}
Findings & signalsGET /findings · GET /signals · POST /signals (from your own tools)
ContractsGET /contracts · renewal review
Agents & outboxGET /agents · PUT /agents/{code} · agent runs approve / reject / revert · /messages/{id}/release | cancel
Insight & evidenceGET /overview · GET /insights · POST /copilot/ask · GET /exports/assure

Bring one vendor and its SOC 2 report

We run the intake, the review lanes, the document findings with page citations, the risk score and the renewal recommendation on your own vendor — in an hour.

Request a demo