Find managed connections by provider type and current state
🔒 Requires Connections: List Connections permission.
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "providerTypes": [
- {
- "value": "MDM",
- "isEnabled": true
}
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}
], - "page": 1,
- "limit": 10,
- "total": 100
}Create an IdP connection requires a file to complete the process
🔒 Requires Personnel & Users: Import Personnel permission.
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}, - "providerError": {
- "provider": "string",
- "status": 0,
- "code": "string",
- "message": "string",
- "details": { }
}
}Update an IdP connection that requires a file to complete the process
🔒 Requires Personnel & Users: Import Personnel permission.
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}, - "providerError": {
- "provider": "string",
- "status": 0,
- "code": "string",
- "message": "string",
- "details": { }
}
}Create an IdP connection that requires personnel list to complete the process
🔒 Requires Personnel & Users: Import Personnel permission.
required | Array of objects (PersonnelDataPublicDto) The list of personnel |
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "personnelData": [
- {
- "id": "233",
- "firstName": "Neil",
- "lastName": "Armstrong",
- "contractor": false,
- "isMfaEnabled": true,
- "jobTitle": "painter",
- "customerId": "A232-23983",
- "date": "2024-10-18T01:28:40"
}
]
}{- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}, - "providerError": {
- "provider": "string",
- "status": 0,
- "code": "string",
- "message": "string",
- "details": { }
}
}Update an IdP connection that requires personnel list to complete the process
🔒 Requires Personnel & Users: Import Personnel permission.
Invalid Authorization
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "personnelData": [
- {
- "id": "233",
- "firstName": "Neil",
- "lastName": "Armstrong",
- "contractor": false,
- "isMfaEnabled": true,
- "jobTitle": "painter",
- "customerId": "A232-23983",
- "date": "2024-10-18T01:28:40"
}
]
}{- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}, - "providerError": {
- "provider": "string",
- "status": 0,
- "code": "string",
- "message": "string",
- "details": { }
}
}