Vanta

Use cases and templates: Vanta integration for AI agents

Vanta is a trust management platform that automates security and compliance for frameworks like SOC 2, ISO 27001, HIPAA, and GDPR. It continuously monitors your infrastructure, people, and vendors through automated tests, and centralizes the evidence auditors need.

With the Vanta integration in Sim, you can:

  • Monitor compliance posture: List frameworks with control, document, and test completion counts, and drill into individual controls and their mapped tests and evidence documents.
  • Triage failing tests: List automated compliance tests by status, framework, integration, or category, and pull the exact failing resource entities that need remediation.
  • Manage evidence documents: List and inspect evidence documents, upload evidence files with descriptions and effective dates, download previously uploaded files, and submit document collections for auditor review.
  • Track people and security tasks: List people with employment status, group membership, and outstanding security tasks (trainings, policy acceptance, background checks, device monitoring).
  • Review policies and vendors: Check policy approval status and versions, and track vendors with risk levels, contract dates, and security review schedules.
  • Stay on top of vulnerabilities: List vulnerabilities with severity and SLA deadline filters, review remediation history, and inspect the vulnerable assets behind each finding.
  • Watch device compliance: List monitored computers with screenlock, disk encryption, password manager, and antivirus check outcomes.
  • Manage risk scenarios: Query risk register scenarios with likelihood/impact scores, treatment decisions, and review status.

Create a Manage Vanta application in Vanta's Developer Console, then add a Vanta credential in Sim with its client ID, client secret, and deployment. Select that saved credential in your Vanta blocks. Sim stores the credentials securely and obtains access tokens automatically; there is no browser authorization redirect or shared Sim OAuth application to configure.

Standard Vanta deployments, including US, EU, and AU tenants, use api.vanta.com; Vanta Gov uses api.vanta-gov.com. Read operations require vanta-api.all:read; submitting documents also requires vanta-api.all:write; evidence uploads require vanta-api.documents:upload. Grant the scopes needed for your workflows when creating the application. See Vanta's authentication documentation.

The first successful connection sets this application's permissions in Sim. Every connection to that application must always use the same permissions, including after tokens expire or credentials are reconnected. Leave permissions blank on reconnect to retain the current choice. To choose different permissions, create a separate Manage Vanta application and connect it in Sim.

If your workflow entered credentials directly on a Vanta block, create and select a saved Vanta credential before running it again. Use a dedicated Vanta application for Sim: Vanta allows one active access token per application, so another client obtaining a new token can invalidate Sim's token.

Use the block

Monitor compliance frameworks, controls, and automated tests; find failing test entities; manage evidence documents including file upload, download, and submission; and track people, policies, vendors, monitored computers, vulnerabilities, and risk scenarios. Select a saved Vanta credential created with your Vanta application client ID and client secret.

Actions

Vanta List Frameworks

List the compliance frameworks (e.g., SOC 2, ISO 27001) available in a Vanta account with completion counts

Input

ParameterTypeRequiredDescription
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
frameworksarrayFrameworks in the Vanta account
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Framework

Get a Vanta compliance framework by ID, including its requirement categories and mapped controls

Input

ParameterTypeRequiredDescription
frameworkIdstringYesUnique ID of the framework (e.g., soc2)

Output

ParameterTypeDescription
frameworkjsonThe requested framework with requirement categories

Vanta List Framework Controls

List the controls that belong to a specific Vanta compliance framework

Input

ParameterTypeRequiredDescription
frameworkIdstringYesUnique ID of the framework (e.g., soc2)
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
controlsarrayControls belonging to the framework
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta List Controls

List the security controls in a Vanta account, optionally filtered by framework

Input

ParameterTypeRequiredDescription
frameworkMatchesAnystringNoComma-separated framework IDs to filter controls by (e.g., soc2,iso27001)
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
controlsarrayControls matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Control

Get a Vanta security control by ID, including its status and evidence pass/fail counts

Input

ParameterTypeRequiredDescription
controlIdstringYesUnique ID of the control

Output

ParameterTypeDescription
controljsonThe requested control with status and evidence counts

Vanta List Control Tests

List the automated tests mapped to a specific Vanta control

Input

ParameterTypeRequiredDescription
controlIdstringYesUnique ID of the control
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
testsarrayTests mapped to the control
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta List Control Documents

List the evidence documents mapped to a specific Vanta control

Input

ParameterTypeRequiredDescription
controlIdstringYesUnique ID of the control
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
documentsarrayDocuments mapped to the control
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta List Tests

List the automated compliance tests in a Vanta account, with filters for status, framework, integration, control, owner, and category

Input

ParameterTypeRequiredDescription
statusFilterstringNoFilter by test status: OK, DEACTIVATED, NEEDS_ATTENTION, IN_PROGRESS, INVALID, or NOT_APPLICABLE
frameworkFilterstringNoFilter by framework ID (e.g., soc2)
integrationFilterstringNoFilter by integration ID (e.g., aws)
controlFilterstringNoFilter by control ID
ownerFilterstringNoFilter by owner user ID
categoryFilterstringNoFilter by test category (e.g., ACCOUNTS_ACCESS, COMPUTERS, INFRASTRUCTURE, POLICIES, VULNERABILITY_MANAGEMENT)
isInRolloutbooleanNoFilter by whether the test is in rollout
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
testsarrayTests matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Test

Get a Vanta automated compliance test by ID, including its status and remediation info

Input

ParameterTypeRequiredDescription
testIdstringYesUnique ID of the test (e.g., test-aws-cloudtrail-enabled)

Output

ParameterTypeDescription
testjsonThe requested test

Vanta List Test Entities

List the failing or deactivated resource entities for a specific Vanta test, useful for finding exactly which resources need remediation

Input

ParameterTypeRequiredDescription
testIdstringYesUnique ID of the test (e.g., test-aws-cloudtrail-enabled)
entityStatusstringNoFilter entities by status: FAILING or DEACTIVATED
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
entitiesarrayResource entities for the test
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta List Documents

List the evidence documents in a Vanta account, optionally filtered by framework or document status

Input

ParameterTypeRequiredDescription
frameworkMatchesAnystringNoComma-separated framework IDs to filter documents by (e.g., soc2,iso27001)
statusMatchesAnystringNoComma-separated document statuses to filter by: "Needs document", "Needs update", "Not relevant", "OK"
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
documentsarrayDocuments matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Document

Get a Vanta evidence document by ID, including its renewal schedule and deactivation status

Input

ParameterTypeRequiredDescription
documentIdstringYesUnique ID of the document

Output

ParameterTypeDescription
documentjsonThe requested document

Vanta List Document Uploads

List the files uploaded to a specific Vanta evidence document

Input

ParameterTypeRequiredDescription
documentIdstringYesUnique ID of the document
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
uploadsarrayFiles uploaded to the document
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Upload Document File

Upload an evidence file to a Vanta document. Requires credentials with the vanta-api.documents:upload scope.

Input

ParameterTypeRequiredDescription
documentIdstringYesUnique ID of the document to attach the file to
filefileNoThe evidence file to upload
fileNamestringNoOptional file name override
mimeTypestringNoMIME type of the file (e.g., application/pdf). Applies only to the base64 upload path; a file from the File input always sends the content type resolved from storage.
descriptionstringNoDescription of the uploaded evidence (e.g., "Q3 access review evidence")
effectiveAtDatestringNoISO 8601 date indicating when the document is effective from

Output

ParameterTypeDescription
uploadjsonMetadata of the uploaded file

Vanta Download Document File

Download a file previously uploaded to a Vanta evidence document and store it in execution files

Input

ParameterTypeRequiredDescription
documentIdstringYesUnique ID of the document
uploadedFileIdstringYesUnique ID of the uploaded file (from List Document Uploads)

Output

ParameterTypeDescription
filefileDownloaded file stored in execution files
namestringName of the downloaded file
mimeTypestringMIME type of the downloaded file
sizenumberSize of the downloaded file in bytes

Vanta Submit Document

Submit a Vanta document collection for review so uploaded evidence becomes visible to auditors. Requires credentials with write access.

Input

ParameterTypeRequiredDescription
documentIdstringYesUnique ID of the document to submit

Output

ParameterTypeDescription
documentIdstringID of the submitted document
submittedbooleanWhether the document collection was submitted

Vanta List People

List the people tracked in a Vanta account with employment status, group membership, and security task completion

Input

ParameterTypeRequiredDescription
emailAndNameFilterstringNoFilter people by email address or name
employmentStatusstringNoFilter by employment status: UPCOMING, CURRENT, ON_LEAVE, INACTIVE, or FORMER
groupIdsMatchesAnystringNoComma-separated group IDs to filter people by
tasksSummaryStatusMatchesAnystringNoComma-separated task summary statuses to filter by: NONE, DUE_SOON, OVERDUE, COMPLETE, PAUSED, OFFBOARDING_DUE_SOON, OFFBOARDING_OVERDUE, OFFBOARDING_COMPLETE
taskTypeMatchesAnystringNoComma-separated task types to filter by: COMPLETE_TRAININGS, ACCEPT_POLICIES, COMPLETE_CUSTOM_TASKS, COMPLETE_CUSTOM_OFFBOARDING_TASKS, INSTALL_DEVICE_MONITORING, COMPLETE_BACKGROUND_CHECKS
taskStatusMatchesAnystringNoComma-separated task statuses to filter by: COMPLETE, DUE_SOON, OVERDUE, NONE
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
peoplearrayPeople matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Person

Get a person tracked in Vanta by ID, including employment, leave, and security task status

Input

ParameterTypeRequiredDescription
personIdstringYesUnique ID of the person

Output

ParameterTypeDescription
personjsonThe requested person

Vanta List Policies

List the security policies in a Vanta account with approval status and version info

Input

ParameterTypeRequiredDescription
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
policiesarrayPolicies in the Vanta account
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Policy

Get a Vanta security policy by ID, including its approval status and latest approved version documents

Input

ParameterTypeRequiredDescription
policyIdstringYesUnique ID of the policy

Output

ParameterTypeDescription
policyjsonThe requested policy

Vanta List Vendors

List the vendors tracked in a Vanta account with risk levels, contract dates, and security review schedules

Input

ParameterTypeRequiredDescription
namestringNoFilter vendors by name
statusMatchesAnystringNoComma-separated vendor statuses to filter by: MANAGED, ARCHIVED, IN_PROCUREMENT
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
vendorsarrayVendors matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Vendor

Get a Vanta vendor by ID, including risk levels, contract details, and authentication info

Input

ParameterTypeRequiredDescription
vendorIdstringYesUnique ID of the vendor

Output

ParameterTypeDescription
vendorjsonThe requested vendor

Vanta List Monitored Computers

List the monitored computers in a Vanta account with screenlock, disk encryption, password manager, and antivirus check outcomes

Input

ParameterTypeRequiredDescription
complianceStatusFilterMatchesAnystringNoComma-separated compliance issues to filter by: PWM_NOT_INSTALLED, HD_NOT_ENCRYPTED, AV_NOT_INSTALLED, SCREENLOCK_NOT_CONFIGURED, LAST_CHECK_OVER_14_DAYS
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
computersarrayMonitored computers matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta List Vulnerabilities

List the vulnerabilities detected across a Vanta account with filters for severity, fixability, SLA deadlines, package, and integration

Input

ParameterTypeRequiredDescription
qstringNoSearch query for vulnerabilities
severitystringNoFilter by severity: LOW, MEDIUM, HIGH, or CRITICAL
isFixAvailablebooleanNoFilter by whether a fix is available
isDeactivatedbooleanNoFilter by whether vulnerability monitoring is deactivated
includeVulnerabilitiesWithoutSlasbooleanNoInclude vulnerabilities that have no SLA deadline
packageIdentifierstringNoFilter by the affected package identifier
externalVulnerabilityIdstringNoFilter by external vulnerability ID (e.g., a CVE identifier)
integrationIdstringNoFilter by the integration that detected the vulnerability
vulnerableAssetIdstringNoFilter by the vulnerable asset ID
slaDeadlineAfterDatestringNoOnly include vulnerabilities with an SLA deadline after this ISO 8601 date
slaDeadlineBeforeDatestringNoOnly include vulnerabilities with an SLA deadline before this ISO 8601 date
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
vulnerabilitiesarrayVulnerabilities matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta List Vulnerability Remediations

List remediated vulnerabilities in a Vanta account with detection, SLA deadline, and remediation dates

Input

ParameterTypeRequiredDescription
integrationIdstringNoFilter by the integration that detected the vulnerability
severitystringNoFilter by severity: LOW, MEDIUM, HIGH, or CRITICAL
isRemediatedOnTimebooleanNoFilter by whether the vulnerability was remediated before its SLA deadline
remediatedAfterDatestringNoOnly include remediations completed after this ISO 8601 date
remediatedBeforeDatestringNoOnly include remediations completed before this ISO 8601 date
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
remediationsarrayVulnerability remediations matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta List Vulnerable Assets

List the assets associated with vulnerabilities in a Vanta account (servers, repositories, workstations, and more)

Input

ParameterTypeRequiredDescription
qstringNoSearch query for vulnerable assets
integrationIdstringNoFilter by the integration scanning the asset
assetTypestringNoFilter by asset type: SERVER, SERVERLESS_FUNCTION, CONTAINER, CONTAINER_REPOSITORY, CONTAINER_REPOSITORY_IMAGE, CODE_REPOSITORY, MANIFEST_FILE, WORKSTATION, or OTHER
assetExternalAccountIdstringNoFilter by the external account ID the asset belongs to
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
assetsarrayVulnerable assets matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Vulnerable Asset

Get a vulnerable asset in Vanta by ID, including the scanners reporting it and per-scanner asset details

Input

ParameterTypeRequiredDescription
vulnerableAssetIdstringYesUnique ID of the vulnerable asset

Output

ParameterTypeDescription
assetjsonThe requested vulnerable asset

Vanta List Risk Scenarios

List the risk scenarios in a Vanta risk register with likelihood/impact scores, treatment decisions, and review status

Input

ParameterTypeRequiredDescription
searchStringstringNoSearch string to filter risk scenarios
includeIgnoredbooleanNoInclude ignored risk scenarios
typestringNoFilter by scenario type: "Risk Scenario" or "Enterprise Risk"
ownerMatchesAnystringNoComma-separated owner emails to filter by
categoryMatchesAnystringNoComma-separated risk categories to filter by
ciaCategoryMatchesAnystringNoComma-separated CIA categories to filter by: Confidentiality, Integrity, Availability
treatmentTypeMatchesAnystringNoComma-separated treatments to filter by: Mitigate, Transfer, Avoid, Accept
inherentScoreGroupMatchesAnystringNoComma-separated inherent score groups to filter by: "Very low", Low, Med, High, Critical
residualScoreGroupMatchesAnystringNoComma-separated residual score groups to filter by: "Very low", Low, Med, High, Critical
reviewStatusMatchesAnystringNoComma-separated review statuses to filter by: APPROVED, DRAFT, NOT_REVIEWED, AWAITING_SUBMISSION, PENDING_APPROVAL, REQUESTED_CHANGES
orderBystringNoField to order results by: description or createdAt
pageSizenumberNoMaximum number of items per page (1-100, default 10)
pageCursorstringNoPagination cursor: pass the endCursor from the previous response to fetch the next page

Output

ParameterTypeDescription
riskScenariosarrayRisk scenarios matching the filters
pageInfojsonCursor pagination info for the returned page; pass endCursor as pageCursor to fetch the next page

Vanta Get Risk Scenario

Get a Vanta risk scenario by ID, including its scores, treatment decision, and review status

Input

ParameterTypeRequiredDescription
riskScenarioIdstringYesUnique ID of the risk scenario

Output

ParameterTypeDescription
riskScenariojsonThe requested risk scenario