Socotra
API ReferenceConfiguration and Development API

Data Access API

Use of this API is dependent on enabling data security. See the associated Data Access Controls and Data Masking guides for details.

ActionEndpoint
Add User Data AccessPATCH/auth/users/{locator}/dataaccess/{tenantLocator}
Fetch User Data AccessGET/auth/users/{locator}/dataaccess
Fetch User Data Access For TenantGET/auth/users/{locator}/dataaccess/{tenantLocator}
Delete User Data AccessDELETE/auth/users/{locator}/dataaccess/{tenantLocator}

Add User Data Access

Add User Data AccessaddUserDataAccess
PATCH/auth/users/{locator}/dataaccess/{tenantLocator}

Parameters

NameInTypeRequiredDescription
locatorpathuuidYes
tenantLocatorpathuuidYes
Security Group:users
Permission:
write

Fetch User Data Access

Fetch User Data AccessfetchUserDataAccess
GET/auth/users/{locator}/dataaccess

Parameters

NameInTypeRequiredDescription
locatorpathuuidYes
Security Group:users
Permission:
read

Fetch User Data Access For Tenant

Fetch User Data Access For TenantfetchUserDataAccessForTenant
GET/auth/users/{locator}/dataaccess/{tenantLocator}

Parameters

NameInTypeRequiredDescription
locatorpathuuidYes
tenantLocatorpathuuidYes
Security Group:users
Permission:
read

Delete User Data Access

Delete User Data AccessdeleteUserDataAccess
DELETE/auth/users/{locator}/dataaccess/{tenantLocator}

Parameters

NameInTypeRequiredDescription
locatorpathuuidYes
tenantLocatorpathuuidYes
Response:void
Security Group:users
Permission:
write
UserDataAccessRequest

Required properties

PropertyTypeDescription
maskingLevelEnum none | level1 | level2
accessControlFieldsmap<string, map<string, string[]>>
UserDataAccessResponse

Required properties

PropertyTypeDescription
tenantLocatoruuid
userLocatoruuid
maskingLevelEnum none | level1 | level2
accessControlFieldsmap<string, map<string, string[]>>

See Also

On this page