Assets

List all the assets

Find assets by search terms and filters

🔒 Requires Assets: List Assets permission.

Securitybearer

Request

query Parameters

page	number [ 1 .. 1000 ] Default: 1 Which page of data are you requesting
limit	number [ 1 .. 50 ] Default: 20 How many items are you requesting
q	string Filter data by searching by asset names Example: q=Security Program Overview
sort	string Which type of sort (default: CREATED) Enum: "NAME" "ASSET_TYPE" "COMPANY_NAME" "DESCRIPTION" "ASSET_PROVIDER" "USER" "APPROVED_AT" "REMOVED_AT" "CREATED" "UPDATED" "EMPLOYMENT_STATUS" Example: sort=NAME
sortDir	string Which direction to sort the data (default: ASC) Enum: "ASC" "DESC" Example: sortDir=ASC
assetClassType	string Filter assets by class type (associated assets) Enum: "HARDWARE" "POLICY" "DOCUMENT" "PERSONNEL" "SOFTWARE" "CODE" "CONTAINER" "COMPUTE" "NETWORKING" "DATABASE" "STORAGE" Example: assetClassType=DOCUMENT
assetType	string Filter assets by type Enum: "PHYSICAL" "VIRTUAL" Example: assetType=PHYSICAL
assetProvider	string Filter assets by provider Enum: "DRATA_DEV" "AGENT" "DRATA" "GOOGLE" "MICROSOFT_365" "JAMF" "INTUNE" "OKTA_IDENTITY" "KANDJI" "JUMPCLOUD" "HEXNODE_UEM" "RIPPLING" "AWS" "MERGEDEV_ONELOGIN" "MERGEDEV_JUMPCLOUD" "WORKSPACE_ONE" "CSV_IDP" "AWS_GOV_CLOUD" "AZURE" "GCP" "MICROSOFT_365_GCC_HIGH" "MERGEDEV_CYBERARK" "KOLIDE" "MERGEDEV_PINGONE" "AWS_ORG_UNITS" "INTUNE_GCC_HIGH" Example: assetProvider=AGENT
userId	number <= 1000000000 Filter data to a user associated to the assets Example: userId=1
employmentStatus	string Filter data to personnel of this employment status Enum: "CURRENT_EMPLOYEE" "FORMER_EMPLOYEE" "CURRENT_CONTRACTOR" "FORMER_CONTRACTOR" "OUT_OF_SCOPE" "UNKNOWN" "SPECIAL_FORMER_EMPLOYEE" "SPECIAL_FORMER_CONTRACTOR" "FUTURE_HIRE" "SERVICE_ACCOUNT" Example: employmentStatus=CURRENT_EMPLOYEE

Responses

200

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

get/assets

Request samples

Response samples

application/json

{"data": [{"id": 1,
"name": "MacbookPro 13",
"description": "MacbookPro 13",
"assetType": "PHYSICAL",
"assetProvider": "AGENT",
"approvedAt": "2025-07-01T16:45:55.246Z",
"removedAt": "2025-07-01T16:45:55.246Z",
"assetClassTypes": "AssetClassTypeResponseDto[]",
"company": "Acme, Inc",
"owner": {"id": 1,
"entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
"email": "[email protected]",
"firstName": "Sally",
"lastName": "Smith",
"jobTitle": "CEO",
"avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
"drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"roles": ["ROLE",
"ANOTHER_ROLE"
],
"backgroundChecks": [{"id": 1,
"userId": 1,
"status": "OK",
"caseId": "abc123",
"caseInvitationId": "abc123",
"url": "https://app-stage.karmacheck.com/background_check/aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
"manualCheckDate": "2020-07-06",
"manuallyCheckUrl": "url.com",
"type": "CERTN",
"source": "DRATA",
"reportData": "string",
"user": { },
"outOfScopeReason": "abc123",
"outOfScopeAt": "2025-07-01T16:45:55.246Z",
"invitationEmail": "[email protected]",
"linkedAt": "2025-07-01T16:45:55.246Z",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z"
}
],
"identities": [{"id": 1,
"identityId": "1a2b3c",
"username": "Username",
"connectedAt": "2025-07-01T16:45:55.246Z",
"disconnectedAt": "2025-07-01T16:45:55.246Z",
"hasMfa": true,
"user": { },
"connection": {"id": "1",
"clientType": "GOOGLE",
"state": "ACTIVE",
"connected": false,
"connectedAt": "2025-07-01T16:45:55.246Z",
"failedAt": "2025-07-01T16:45:55.246Z",
"companyId": "12341234",
"assignmentId": "FLk12AsS",
"user": { },
"accountId": "string",
"clientId": "abc123",
"clientAlias": "My-connection-alias-1",
"manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
"aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
"deletedAt": "2025-07-01T16:45:55.246Z",
"requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
"product": { },
"writeAccessEnabled": false,
"sourcePreference": "LABEL",
"securityLabel": "Jira Security Label",
"jqlQuery": "project = IT AND type = \"Offboarding\"",
"authorized": true,
"workspaces": [{"id": 1,
"name": "Drata",
"description": "Platform to track SOC 2 compliance within the organization",
"howItWorks": null,
"url": "https://app.drata.com",
"logo": "https://cdn.drata.com/icon/icon_fwhite_bblue_256.png",
"primary": true
}
],
"providerTypes": [5
],
"code": 10010,
"groupLabel": "Everyone"
},
"hasIdp": true,
"secondaryEmail": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"startedAt": "2025-07-01T16:45:55.246Z",
"separatedAt": "2025-07-01T16:45:55.246Z",
"isContractor": true,
"jobTitle": "Engineer",
"managerId": "x00jk12-2312",
"managerName": "string"
}
],
"documents": [{"data": [{"id": null,
"name": null,
"type": null,
"fileUrl": null,
"renewalDate": null,
"createdAt": null,
"updatedAt": null
}
],
"page": 1,
"limit": 10,
"total": 100
}
]
},
"employmentStatus": "CURRENT_EMPLOYEE",
"notes": "string",
"assetReferenceType": "PERSONNEL",
"uniqueId": "C02T6CDJGTFL",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"device": {"id": 1,
"osVersion": "MacOS 10.15.6",
"serialNumber": "C02T6CDJGTFL",
"model": "MacBook Pro",
"macAddress": "65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E",
"encryptionEnabled": false,
"encryptionExplanation": "No encryption provided",
"firewallEnabled": true,
"firewallExplanation": "{}",
"lastCheckedAt": "2025-07-01T16:45:55.246Z",
"sourceType": "AGENT",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"deletedAt": "2025-07-01T16:45:55.246Z",
"appsCount": 20,
"complianceChecks": [ ],
"identifiers": [ ],
"documents": [ ],
"isDeviceCompliant": false,
"screenLockTime": "60",
"screenLockExplanation": {"minutesIdleBeforeSleep": "2",
"minutesSleepingBeforePasswordIsRequired": "2"
},
"antivirusEnabled": true,
"antivirusExplanation": "No matching app was found",
"autoUpdateEnabled": true,
"autoUpdateExplanation": "No compliances found",
"passwordManagerEnabled": true,
"passwordManagerExplanation": {"passwordManagerApps": ["1password 7"
]
},
"agentVersion": "1.0"
},
"externalId": "i-0c844e3b433e4e3f",
"externalOwnerId": "account-353"
}
],
"page": 1,
"limit": 10,
"total": 100
}

Create one manual asset

Manually add a new asset to the account

🔒 Requires Assets: Create Asset permission.

Securitybearer

Request

Request Body schema: application/json
required

name required	string <= 191 characters The asset name
description required	string <= 191 characters The asset description
notes	string <= 191 characters The asset notes
assetClassTypes required	Array of strings The asset class types Items Enum: "HARDWARE" "POLICY" "DOCUMENT" "PERSONNEL" "SOFTWARE" "CODE" "CONTAINER" "COMPUTE" "NETWORKING" "DATABASE" "STORAGE"
assetType required	string The asset type Enum: "PHYSICAL" "VIRTUAL"
ownerId required	number The owner id
uniqueId	string Unique Id associated with this asset
removedAt	string <date-time> Date the asset was removed
externalId	string An externally sourced unique identifier for a virtual asset
externalOwnerId	string Used to track the source of virtual assets, typically an account id

Responses

201

Created

400

Malformed data and/or validation errors

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

404

Not Found

412

You must accept the Drata terms and conditions to use the API

422

Unprocessable Entity

500

Internal server error

post/assets

Request samples

application/json

{"name": "Asset name",
"description": "This is a description",
"notes": "This is a note",
"assetClassTypes": ["HARDWARE",
"PERSONNEL"
],
"assetType": "PHYSICAL",
"ownerId": 1,
"uniqueId": "C02T6CDJGTFL",
"removedAt": "2025-07-01T16:45:55.246Z",
"externalId": "i-0c844e3b433e4e3f",
"externalOwnerId": "account-353"
}

Response samples

application/json

{"id": 1,
"name": "MacbookPro 13",
"description": "MacbookPro 13",
"assetType": "PHYSICAL",
"assetProvider": "AGENT",
"approvedAt": "2025-07-01T16:45:55.246Z",
"removedAt": "2025-07-01T16:45:55.246Z",
"assetClassTypes": "AssetClassTypeResponseDto[]",
"company": "Acme, Inc",
"owner": {"id": 1,
"entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
"email": "[email protected]",
"firstName": "Sally",
"lastName": "Smith",
"jobTitle": "CEO",
"avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
"drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"roles": ["ROLE",
"ANOTHER_ROLE"
],
"backgroundChecks": [{"id": 1,
"userId": 1,
"status": "OK",
"caseId": "abc123",
"caseInvitationId": "abc123",
"url": "https://app-stage.karmacheck.com/background_check/aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
"manualCheckDate": "2020-07-06",
"manuallyCheckUrl": "url.com",
"type": "CERTN",
"source": "DRATA",
"reportData": "string",
"user": { },
"outOfScopeReason": "abc123",
"outOfScopeAt": "2025-07-01T16:45:55.246Z",
"invitationEmail": "[email protected]",
"linkedAt": "2025-07-01T16:45:55.246Z",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z"
}
],
"identities": [{"id": 1,
"identityId": "1a2b3c",
"username": "Username",
"connectedAt": "2025-07-01T16:45:55.246Z",
"disconnectedAt": "2025-07-01T16:45:55.246Z",
"hasMfa": true,
"user": { },
"connection": {"id": "1",
"clientType": "GOOGLE",
"state": "ACTIVE",
"connected": false,
"connectedAt": "2025-07-01T16:45:55.246Z",
"failedAt": "2025-07-01T16:45:55.246Z",
"companyId": "12341234",
"assignmentId": "FLk12AsS",
"user": { },
"accountId": "string",
"clientId": "abc123",
"clientAlias": "My-connection-alias-1",
"manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
"aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
"deletedAt": "2025-07-01T16:45:55.246Z",
"requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
"product": { },
"writeAccessEnabled": false,
"sourcePreference": "LABEL",
"securityLabel": "Jira Security Label",
"jqlQuery": "project = IT AND type = \"Offboarding\"",
"authorized": true,
"workspaces": [{"id": 1,
"name": "Drata",
"description": "Platform to track SOC 2 compliance within the organization",
"howItWorks": null,
"url": "https://app.drata.com",
"logo": "https://cdn.drata.com/icon/icon_fwhite_bblue_256.png",
"primary": true
}
],
"providerTypes": [5
],
"code": 10010,
"groupLabel": "Everyone"
},
"hasIdp": true,
"secondaryEmail": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"startedAt": "2025-07-01T16:45:55.246Z",
"separatedAt": "2025-07-01T16:45:55.246Z",
"isContractor": true,
"jobTitle": "Engineer",
"managerId": "x00jk12-2312",
"managerName": "string"
}
],
"documents": [{"data": [{"id": 1,
"name": "Security Training",
"type": "SEC_TRAINING",
"fileUrl": "http://localhost:5000/download/documents/1",
"renewalDate": "2026-10-27",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z"
}
],
"page": 1,
"limit": 10,
"total": 100
}
]
},
"employmentStatus": "CURRENT_EMPLOYEE",
"notes": "string",
"assetReferenceType": "PERSONNEL",
"uniqueId": "C02T6CDJGTFL",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"device": {"id": 1,
"osVersion": "MacOS 10.15.6",
"serialNumber": "C02T6CDJGTFL",
"model": "MacBook Pro",
"macAddress": "65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E",
"encryptionEnabled": false,
"encryptionExplanation": "No encryption provided",
"firewallEnabled": true,
"firewallExplanation": "{}",
"lastCheckedAt": "2025-07-01T16:45:55.246Z",
"sourceType": "AGENT",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"deletedAt": "2025-07-01T16:45:55.246Z",
"appsCount": 20,
"complianceChecks": [ ],
"identifiers": [ ],
"documents": [ ],
"isDeviceCompliant": false,
"screenLockTime": "60",
"screenLockExplanation": {"minutesIdleBeforeSleep": "2",
"minutesSleepingBeforePasswordIsRequired": "2"
},
"antivirusEnabled": true,
"antivirusExplanation": "No matching app was found",
"autoUpdateEnabled": true,
"autoUpdateExplanation": "No compliances found",
"passwordManagerEnabled": true,
"passwordManagerExplanation": {"passwordManagerApps": ["1password 7"
]
},
"agentVersion": "1.0"
},
"externalId": "i-0c844e3b433e4e3f",
"externalOwnerId": "account-353"
}

Remove an asset by asset ID

Remove a virtual or manually-added asset. ⚠️ This is an unrecoverable operation

🔒 Requires Assets: Delete Asset permission.

Securitybearer

Request

path Parameters

required

number

Responses

200

400

Malformed data and/or validation errors

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

404

Not Found

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

delete/assets/{id}

Request samples

Response samples

application/json

{"id": 1,
"name": "MacbookPro 13",
"description": "MacbookPro 13",
"assetType": "PHYSICAL",
"assetProvider": "AGENT",
"approvedAt": "2025-07-01T16:45:55.246Z",
"removedAt": "2025-07-01T16:45:55.246Z",
"assetClassTypes": "AssetClassTypeResponseDto[]",
"company": "Acme, Inc",
"owner": {"id": 1,
"entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
"email": "[email protected]",
"firstName": "Sally",
"lastName": "Smith",
"jobTitle": "CEO",
"avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
"drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"roles": ["ROLE",
"ANOTHER_ROLE"
],
"backgroundChecks": [{"id": 1,
"userId": 1,
"status": "OK",
"caseId": "abc123",
"caseInvitationId": "abc123",
"url": "https://app-stage.karmacheck.com/background_check/aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
"manualCheckDate": "2020-07-06",
"manuallyCheckUrl": "url.com",
"type": "CERTN",
"source": "DRATA",
"reportData": "string",
"user": { },
"outOfScopeReason": "abc123",
"outOfScopeAt": "2025-07-01T16:45:55.246Z",
"invitationEmail": "[email protected]",
"linkedAt": "2025-07-01T16:45:55.246Z",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z"
}
],
"identities": [{"id": 1,
"identityId": "1a2b3c",
"username": "Username",
"connectedAt": "2025-07-01T16:45:55.246Z",
"disconnectedAt": "2025-07-01T16:45:55.246Z",
"hasMfa": true,
"user": { },
"connection": {"id": "1",
"clientType": "GOOGLE",
"state": "ACTIVE",
"connected": false,
"connectedAt": "2025-07-01T16:45:55.246Z",
"failedAt": "2025-07-01T16:45:55.246Z",
"companyId": "12341234",
"assignmentId": "FLk12AsS",
"user": { },
"accountId": "string",
"clientId": "abc123",
"clientAlias": "My-connection-alias-1",
"manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
"aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
"deletedAt": "2025-07-01T16:45:55.246Z",
"requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
"product": { },
"writeAccessEnabled": false,
"sourcePreference": "LABEL",
"securityLabel": "Jira Security Label",
"jqlQuery": "project = IT AND type = \"Offboarding\"",
"authorized": true,
"workspaces": [{"id": 1,
"name": "Drata",
"description": "Platform to track SOC 2 compliance within the organization",
"howItWorks": null,
"url": "https://app.drata.com",
"logo": "https://cdn.drata.com/icon/icon_fwhite_bblue_256.png",
"primary": true
}
],
"providerTypes": [5
],
"code": 10010,
"groupLabel": "Everyone"
},
"hasIdp": true,
"secondaryEmail": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"startedAt": "2025-07-01T16:45:55.246Z",
"separatedAt": "2025-07-01T16:45:55.246Z",
"isContractor": true,
"jobTitle": "Engineer",
"managerId": "x00jk12-2312",
"managerName": "string"
}
],
"documents": [{"data": [{"id": 1,
"name": "Security Training",
"type": "SEC_TRAINING",
"fileUrl": "http://localhost:5000/download/documents/1",
"renewalDate": "2026-10-27",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z"
}
],
"page": 1,
"limit": 10,
"total": 100
}
]
},
"employmentStatus": "CURRENT_EMPLOYEE",
"notes": "string",
"assetReferenceType": "PERSONNEL",
"uniqueId": "C02T6CDJGTFL",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"device": {"id": 1,
"osVersion": "MacOS 10.15.6",
"serialNumber": "C02T6CDJGTFL",
"model": "MacBook Pro",
"macAddress": "65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E",
"encryptionEnabled": false,
"encryptionExplanation": "No encryption provided",
"firewallEnabled": true,
"firewallExplanation": "{}",
"lastCheckedAt": "2025-07-01T16:45:55.246Z",
"sourceType": "AGENT",
"createdAt": "2025-07-01T16:45:55.246Z",
"updatedAt": "2025-07-01T16:45:55.246Z",
"deletedAt": "2025-07-01T16:45:55.246Z",
"appsCount": 20,
"complianceChecks": [ ],
"identifiers": [ ],
"documents": [ ],
"isDeviceCompliant": false,
"screenLockTime": "60",
"screenLockExplanation": {"minutesIdleBeforeSleep": "2",
"minutesSleepingBeforePasswordIsRequired": "2"
},
"antivirusEnabled": true,
"antivirusExplanation": "No matching app was found",
"autoUpdateEnabled": true,
"autoUpdateExplanation": "No compliances found",
"passwordManagerEnabled": true,
"passwordManagerExplanation": {"passwordManagerApps": ["1password 7"
]
},
"agentVersion": "1.0"
},
"externalId": "i-0c844e3b433e4e3f",
"externalOwnerId": "account-353"
}

Assets

List all the assets

query Parameters

Create one manual asset

Request Body schema: application/jsonrequired

Remove an asset by asset ID

path Parameters

Request Body schema: application/json
required