Skip to main content
DataGrail
Betav0.1.0
39 actions · 1 auth method
Security

​
Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and set up a Connector Profile in your project. See Setup Connector Profile.

Connector Profile · API Key

Requires API access to be enabled on your DataGrail environment by an Account Manager. The key is created in the DataGra…
3

Link an Account

Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

Link Account · API Key

4

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

​
Actions

39 actions
Action
Description
List Assessments
Returns paginated list of assessments with optional filtering. Only returns current versions - superseded assessments ar…
Create Assessment
Create a new assessment from a template, optionally linked to systems. The assessment starts in not_started status. The…
Get Assessment
Returns full assessment detail including the form with current answers, per-question visibility flags, progress, and app…
Submit Assessment Answers
Atomically submits one or more answers for an assessment. All answers are validated before any are persisted — if any an…
Assign Assessment Approver
Sets the assessment approver from an email, so a procurement system driving assessments over the API can route sign-off…
Approve Assessment
Approves an assessment, so a procurement system driving assessments over the API can sign off without a user opening the…
Upload Assessment Document
Uploads a document to an assessment. The document is attributed to one of your active users, identified by uploader_emai…
Download Assessment PDF
Download a completed assessment as a PDF document. Only available for assessments in approved status.
List Assessment Templates
Returns paginated list of assessment templates available to the customer, including platform defaults.
Get Assessment Template
Returns full assessment template detail including sections and question schema. Divider-type questions are excluded.
List Consent Audit Log Exports
Returns a list of monthly consent audit log export files. Each export covers one calendar month and is updated nightly…
Download Consent Audit Log Export
Downloads the contents of a specific monthly audit log export file. The response is a JSON file containing an array of i…
List Data Discovery Integrations
GET a list of integrations for an authenticated agent.
Get Data Discovery Integration
GET an RDD integration for an authenticated agent.
Create Data Discovery Integration
POST RDD integration details for a system to be scanned using an authenticated agent. If successful, the newly created i…
Update Data Discovery Integration
UPDATE RDD integration details for a system to be scanned using an authenticated agent. Note that names are required to…
Delete Data Discovery Integration
DELETE an RDD integration for an authenticated agent
List Opt Out Integrations
Get a list of opt out integrations
Update Opt Out Integration
Update an opt out integration
List Opt Out Requests
Get a list of opt out requests
Get Opt Out Request
Get an opt out request
Create Opt Out Request
Create an opt out request
Update Opt Out Request
Update an opt out request
Sync Remote Files To Integration
Sync remote files to the integration
Upload Files To Integration
Upload files to the integration
List Privacy Request Integrations
Get a list of privacy request integrations
Update Privacy Request Integration
Update a privacy request integration
List Privacy Request Policies
Get a list of privacy request policies
List Privacy Requests
Get a list of privacy requests
Get Privacy Request
Get a privacy request
Create Privacy Request
Create a privacy request
Update Privacy Request
Update a privacy request
Create Scan Schedule
POST a cron expression to perform data discovery scans for a given integration. If successful, the newly created schedul…
List Scan Schedules
GET a list of schedules for an integration.
Get Scan Schedule
GET a schedule for an integration
Update Scan Schedule
UPDATE the schedule of an integration.
Delete Scan Schedule
DELETE an integration schedule and use DataGrail defaults
List Security Audit Logs
Returns login and permission-decision audit log entries for the current customer. With no pagination parameter, up to 10…
Create Detected Objects
Create Detected Objects