Users are are people with access to the Drata platform.
Roles grant permissions to Users. The help docs have more information on the default Roles.
Find Roles matching the provided filters.
🔒 Requires Roles: List Roles permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
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,
- "role": "ADMIN",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "permissions": [
- {
- "id": 1,
- "action": "READ",
- "subject": "Asset",
- "createdAt": "2019-08-24T14:15:22Z"
}
]
}
], - "pagination": {
- "cursor": "string"
}
}
Get the full detail of a Role record.
🔒 Requires Roles: Get Role permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "role": "ADMIN",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "permissions": [
- {
- "id": 1,
- "action": "READ",
- "subject": "Asset",
- "createdAt": "2019-08-24T14:15:22Z"
}
]
}
List all Users that have a specific Role assigned.
🔒 Requires Users: List Users permission.
required | number or string An integer Role ID or name prefixed with |
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 0,
- "userId": 0,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "documents": [
- {
- "id": 1,
- "userId": 0,
- "downloadUrl": {
- "fileBuffer": {
- "buffer": "RXhhbXBsZSB0ZXh0IGNvbnRlbnQ="
}
}, - "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2020-07-06",
- "updatedAt": "2020-07-06"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "johndoe",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "userId": 1,
- "connectionId": 1,
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "clientId": "drata.com",
- "clientAlias": "My-connection-alias-1",
- "state": "ACTIVE",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z"
}, - "firstName": "John",
- "lastName": "Doe",
- "startedAt": "Wed Sep 03 2025",
- "separatedAt": "Wed Sep 03 2025",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "Jose Díaz",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}
], - "pagination": {
- "cursor": "string"
}
}
Find Users matching the provided filters.
🔒 Requires Users: List Users permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
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,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 0,
- "userId": 0,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "documents": [
- {
- "id": 1,
- "userId": 0,
- "downloadUrl": {
- "fileBuffer": {
- "buffer": "RXhhbXBsZSB0ZXh0IGNvbnRlbnQ="
}
}, - "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2020-07-06",
- "updatedAt": "2020-07-06"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "johndoe",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "userId": 1,
- "connectionId": 1,
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "clientId": "drata.com",
- "clientAlias": "My-connection-alias-1",
- "state": "ACTIVE",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z"
}, - "firstName": "John",
- "lastName": "Doe",
- "startedAt": "Wed Sep 03 2025",
- "separatedAt": "Wed Sep 03 2025",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "Jose Díaz",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}
], - "pagination": {
- "cursor": "string"
}
}
Get the full detail of a User record.
🔒 Requires Users: Get User permission.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 0,
- "userId": 0,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "documents": [
- {
- "id": 1,
- "userId": 0,
- "downloadUrl": {
- "fileBuffer": {
- "buffer": "RXhhbXBsZSB0ZXh0IGNvbnRlbnQ="
}
}, - "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2020-07-06",
- "updatedAt": "2020-07-06"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "johndoe",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "userId": 1,
- "connectionId": 1,
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "clientId": "drata.com",
- "clientAlias": "My-connection-alias-1",
- "state": "ACTIVE",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z"
}, - "firstName": "John",
- "lastName": "Doe",
- "startedAt": "Wed Sep 03 2025",
- "separatedAt": "Wed Sep 03 2025",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "Jose Díaz",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}