Dixa

This documentation for the Dixa integration describes the technical capabilities of this integration, including authorization, scopes/permissions, and utilized endpoints. For more information on how to integrate Dixa, visit our connection instructions.

Version

This integration utilizes the Dixa REST API v1.

Base URL

The base URL used for all Dixa API endpoints:

https://dev.dixa.io/v1

---

Authentication & Authorization

The DataGrail Dixa integration connects using token authentication which requires an API Token.

Sensitive Credentials

Publicly exposing your API credentials can allow unauthorized access to Dixa API endpoints by a third party. DataGrail stores your API credentials encrypted and protected.

Endpoints Utilized

DataGrail uses the following endpoints to authorize and test the connection:

Method	Endpoint	Purpose	Docs
GET	/organization	Validate credentials

---

Capabilities

Access

DataGrail's Dixa integration provides Synchronous Access capabilities for the following supported identifier categories: Email and Phone Number.

Data Interactions

For Access requests, DataGrail will take the following actions:

1. Search Users by the Data Subject email or phone number.
2. If a match is found, DataGrail will extract information about the user (emails, phones, name, etc..).

Endpoints Utilized

Method	Endpoint	Purpose	Docs
GET	/endusers	Search user by email or phone number

---

Deletion

DataGrail's Dixa integration provides Asynchronous (Whole Record) Deletion capabilities for the following supported identifier categories: Email and Phone Number.

Data Interactions

For Deletion requests, DataGrail will take the following actions:

1. Search Users by the Data Subject email or phone number.
2. Submit a deletion request to anonymize the user, their conversations, and their messages.
3. Poll the deletion status periodically until Dixa reports that anonymization is complete.

Endpoints Utilized

Method	Endpoint	Purpose	Docs
GET	/anonymization/request/{request_id}	Retrieve an anonymization request status
GET	/endusers	Search user by email or phone number
PATCH	/endusers/{user_id}/anonymize	Request the anonymization of an end user

---