Assets

Assets let you build an inventory of policies, personnel and computer infrastructure. The help docs have more information.

List Assets

Find Assets by search terms and filters.

🔒 Requires Assets: List Assets permission.

Securitybearer
Request
query Parameters
cursor
string

This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a pagination.cursor value that can be used in the subsequent request to retrieve the next page of results

size
number [ 1 .. 50 ]
Default: 20

Number of results to return

sort
string (SortTypeLimitedEnum)

Which field to sort by

Enum: "createdAt" "updatedAt"
sortDir
string (SortDirectionEnum)

The direction to sort the data

Enum: "ASC" "DESC"
expand[]
Array of strings (AssetExpandEnum)

List of subcollections and sub-objects to expand

Items Enum: "device" "assetClassTypes" "complianceChecks" "customFields" "identifiers" "owner"
assetClassType
string (AssetClassTypeEnum)

Filter assets by class type. This filter is only supported in conjunction with expand[]=assetClassTypes.

Enum: "HARDWARE" "POLICY" "DOCUMENT" "PERSONNEL" "SOFTWARE" "CODE" "CONTAINER" "COMPUTE" "NETWORKING" "DATABASE" "STORAGE"
assetType
string (AssetTypeEnum)

Filter assets by type

Enum: "PHYSICAL" "VIRTUAL"
assetProvider
string (AssetProviderEnum)

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"
userId
number <= 1000000000

Filter data by user ID associated to the Assets

Example: userId=1
employmentStatus
string (EmploymentStatusEnum)

Filter data by personnel of this employment status

Enum Value Description
CURRENT_EMPLOYEE

Current Employee

FORMER_EMPLOYEE

Former Employee

CURRENT_CONTRACTOR

Current Contractor

FORMER_CONTRACTOR

Former Contractor

FUTURE_HIRE

Future Hire – Based on the HRIS data

UNKNOWN

Unknown – The personnel did not match an HRIS record

OUT_OF_SCOPE

Out of Scope – Manually marked as out of scope

SERVICE_ACCOUNT

Service Account – Automatically marked as out of scope

SPECIAL_FORMER_EMPLOYEE

Special Former Employee – Deprecated status for manually created personnel

SPECIAL_FORMER_CONTRACTOR

Special Former Contractor – Deprecated status for manually created personnel

Responses
200

Successful

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": "MacBook Pro 16-inch",
      • "description": "MacBook Pro 16-inch with 14-Core CPU 32-Core GPU 36GB Unified Memory 1TB SSD Storage",
      • "assetType": "PHYSICAL",
      • "assetProvider": "AGENT",
      • "removedAt": "2025-07-01T16:45:55.246Z",
      • "assetClassTypes": "AssetClassTypeResponsePublicV2Dto[]",
      • "owner": {
        • "id": 1,
        • "email": "[email protected]",
        • "firstName": "Sally",
        • "lastName": "Smith",
        • "createdAt": "2025-07-01T16:45:55.246Z",
        • "updatedAt": "2025-07-01T16:45:55.246Z",
        • "jobTitle": "CEO",
        • "avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
        • "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
        • "roles": [
          • "ROLE",
          • "ANOTHER_ROLE"
          ],
        • "backgroundChecks": [
          • {
            • "id": 0,
            • "userId": 0,
            • "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",
            • "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"
            }
          ],
        • "documents": [],
        • "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"
              },
            • "email": "[email protected]",
            • "secondaryEmail": "[email protected]",
            • "firstName": "John",
            • "lastName": "Doe",
            • "startedAt": "Thu Aug 14 2025",
            • "separatedAt": "Thu Aug 14 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"
            }
          ]
        },
      • "notes": "string",
      • "assetReferenceType": "PERSONNEL",
      • "associatedId": "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",
        • "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,
        • "isDeviceCompliant": false,
        • "complianceChecks": [ ],
        • "identifiers": [ ],
        • "documents": [ ],
        • "screenLockTime": 30,
        • "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"
            ]
          },
        • "encryptionEnabled": false,
        • "encryptionExplanation": "No encryption provided",
        • "firewallEnabled": true,
        • "firewallExplanation": "{}",
        • "asset": {
          • "id": 1,
          • "name": "MacBook Pro - Space Black 16-inch",
          • "description": "MacBook Pro Space Black - with 16-inch Liquid Retina XDR display",
          • "assetType": "PHYSICAL",
          • "assetProvider": "AGENT",
          • "approvedAt": "2025-07-01T16:45:55.246Z",
          • "removedAt": "2025-07-01T16:45:55.246Z",
          • "company": "Acme, Inc",
          • "notes": "string",
          • "assetReferenceType": "PERSONNEL",
          • "uniqueId": "C02T6CDJGTFL",
          • "createdAt": "2025-07-01T16:45:55.246Z",
          • "updatedAt": "2025-07-01T16:45:55.246Z",
          • "externalId": "i-0c844e3b433e4e3f",
          • "externalOwnerId": "account-353"
          },
        • "userId": 1,
        • "personnelId": 1,
        • "externalId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd"
        },
      • "externalId": "i-0c844e3b433e4e3f",
      • "externalOwnerId": "account-353",
      • "customFields": [
        • {
          • "customFieldId": 1,
          • "name": "Stakeholders",
          • "value": "Security & IT"
          }
        ]
      }
    ],
  • "pagination": {
    • "cursor": "string"
    }
}
Create 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 (AssetClassTypeEnum) 
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


 
associatedId
string
An 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


 
Array of objects (CustomFieldSubmitRequestPublicV2Dto) 
Custom Fields for the Asset


 
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": "string",
  • "description": "string",
  • "notes": "string",
  • "assetClassTypes": [
    • "HARDWARE",
    • "PERSONNEL"
    ],
  • "assetType": "PHYSICAL",
  • "ownerId": 1,
  • "associatedId": "C02T6CDJGTFL",
  • "removedAt": "2025-07-01T16:45:55.246Z",
  • "externalId": "i-0c844e3b433e4e3f",
  • "externalOwnerId": "account-353",
  • "customFields": [
    • {
      • "id": 1,
      • "name": "Compliance Status",
      • "value": "Security & IT"
      }
    ]
}
Response samples 
application/json
{
  • "id": 1,
  • "name": "MacBook Pro 16-inch",
  • "description": "MacBook Pro 16-inch with 14-Core CPU 32-Core GPU 36GB Unified Memory 1TB SSD Storage",
  • "assetType": "PHYSICAL",
  • "assetProvider": "AGENT",
  • "removedAt": "2025-07-01T16:45:55.246Z",
  • "assetClassTypes": "AssetClassTypeResponsePublicV2Dto[]",
  • "owner": {
    • "id": 1,
    • "email": "[email protected]",
    • "firstName": "Sally",
    • "lastName": "Smith",
    • "createdAt": "2025-07-01T16:45:55.246Z",
    • "updatedAt": "2025-07-01T16:45:55.246Z",
    • "jobTitle": "CEO",
    • "avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
    • "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
    • "roles": [
      • "ROLE",
      • "ANOTHER_ROLE"
      ],
    • "backgroundChecks": [
      • {
        • "id": 0,
        • "userId": 0,
        • "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",
        • "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"
        }
      ],
    • "documents": [],
    • "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"
          },
        • "email": "[email protected]",
        • "secondaryEmail": "[email protected]",
        • "firstName": "John",
        • "lastName": "Doe",
        • "startedAt": "Thu Aug 14 2025",
        • "separatedAt": "Thu Aug 14 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"
        }
      ]
    },
  • "notes": "string",
  • "assetReferenceType": "PERSONNEL",
  • "associatedId": "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",
    • "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,
    • "isDeviceCompliant": false,
    • "complianceChecks": [ ],
    • "identifiers": [ ],
    • "documents": [ ],
    • "screenLockTime": 30,
    • "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"
        ]
      },
    • "encryptionEnabled": false,
    • "encryptionExplanation": "No encryption provided",
    • "firewallEnabled": true,
    • "firewallExplanation": "{}",
    • "asset": {
      • "id": 1,
      • "name": "MacBook Pro - Space Black 16-inch",
      • "description": "MacBook Pro Space Black - with 16-inch Liquid Retina XDR display",
      • "assetType": "PHYSICAL",
      • "assetProvider": "AGENT",
      • "approvedAt": "2025-07-01T16:45:55.246Z",
      • "removedAt": "2025-07-01T16:45:55.246Z",
      • "company": "Acme, Inc",
      • "notes": "string",
      • "assetReferenceType": "PERSONNEL",
      • "uniqueId": "C02T6CDJGTFL",
      • "createdAt": "2025-07-01T16:45:55.246Z",
      • "updatedAt": "2025-07-01T16:45:55.246Z",
      • "externalId": "i-0c844e3b433e4e3f",
      • "externalOwnerId": "account-353"
      },
    • "userId": 1,
    • "personnelId": 1,
    • "externalId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd"
    },
  • "externalId": "i-0c844e3b433e4e3f",
  • "externalOwnerId": "account-353",
  • "customFields": [
    • {
      • "customFieldId": 1,
      • "name": "Stakeholders",
      • "value": "Security & IT"
      }
    ]
}
Get Asset
🔒 Requires Assets: List Assets permission.


Securitybearer 
Request 
path Parameters
assetId
required
number
 
query Parameters
expand[]
Array of strings (AssetExpandEnum) 
List of subcollections and sub-objects to expand


Items Enum: "device" "assetClassTypes" "complianceChecks" "customFields" "identifiers" "owner"  
Responses 
200
Successful


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/{assetId}
Request samples 
Response samples 
application/json
{
  • "id": 1,
  • "name": "MacBook Pro 16-inch",
  • "description": "MacBook Pro 16-inch with 14-Core CPU 32-Core GPU 36GB Unified Memory 1TB SSD Storage",
  • "assetType": "PHYSICAL",
  • "assetProvider": "AGENT",
  • "removedAt": "2025-07-01T16:45:55.246Z",
  • "assetClassTypes": "AssetClassTypeResponsePublicV2Dto[]",
  • "owner": {
    • "id": 1,
    • "email": "[email protected]",
    • "firstName": "Sally",
    • "lastName": "Smith",
    • "createdAt": "2025-07-01T16:45:55.246Z",
    • "updatedAt": "2025-07-01T16:45:55.246Z",
    • "jobTitle": "CEO",
    • "avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
    • "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
    • "roles": [
      • "ROLE",
      • "ANOTHER_ROLE"
      ],
    • "backgroundChecks": [
      • {
        • "id": 0,
        • "userId": 0,
        • "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",
        • "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"
        }
      ],
    • "documents": [],
    • "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"
          },
        • "email": "[email protected]",
        • "secondaryEmail": "[email protected]",
        • "firstName": "John",
        • "lastName": "Doe",
        • "startedAt": "Thu Aug 14 2025",
        • "separatedAt": "Thu Aug 14 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"
        }
      ]
    },
  • "notes": "string",
  • "assetReferenceType": "PERSONNEL",
  • "associatedId": "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",
    • "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,
    • "isDeviceCompliant": false,
    • "complianceChecks": [ ],
    • "identifiers": [ ],
    • "documents": [ ],
    • "screenLockTime": 30,
    • "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"
        ]
      },
    • "encryptionEnabled": false,
    • "encryptionExplanation": "No encryption provided",
    • "firewallEnabled": true,
    • "firewallExplanation": "{}",
    • "asset": {
      • "id": 1,
      • "name": "MacBook Pro - Space Black 16-inch",
      • "description": "MacBook Pro Space Black - with 16-inch Liquid Retina XDR display",
      • "assetType": "PHYSICAL",
      • "assetProvider": "AGENT",
      • "approvedAt": "2025-07-01T16:45:55.246Z",
      • "removedAt": "2025-07-01T16:45:55.246Z",
      • "company": "Acme, Inc",
      • "notes": "string",
      • "assetReferenceType": "PERSONNEL",
      • "uniqueId": "C02T6CDJGTFL",
      • "createdAt": "2025-07-01T16:45:55.246Z",
      • "updatedAt": "2025-07-01T16:45:55.246Z",
      • "externalId": "i-0c844e3b433e4e3f",
      • "externalOwnerId": "account-353"
      },
    • "userId": 1,
    • "personnelId": 1,
    • "externalId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd"
    },
  • "externalId": "i-0c844e3b433e4e3f",
  • "externalOwnerId": "account-353",
  • "customFields": [
    • {
      • "customFieldId": 1,
      • "name": "Stakeholders",
      • "value": "Security & IT"
      }
    ]
}
Update Asset
Update Asset


🔒 Requires Assets: Update Asset permission.


Securitybearer 
Request 
path Parameters
assetId
required
number
 
Request Body schema: application/json
required
description
string  <= 191 characters 
The Asset description


 
notes
string  <= 191 characters 
The Asset notes


 
Responses 
200
Successful


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


put/assets/{assetId}
Request samples 
application/json
{
  • "description": "string",
  • "notes": "string"
}
Response samples 
application/json
{
  • "id": 1,
  • "name": "MacBook Pro 16-inch",
  • "description": "MacBook Pro 16-inch with 14-Core CPU 32-Core GPU 36GB Unified Memory 1TB SSD Storage",
  • "assetType": "PHYSICAL",
  • "assetProvider": "AGENT",
  • "removedAt": "2025-07-01T16:45:55.246Z",
  • "assetClassTypes": "AssetClassTypeResponsePublicV2Dto[]",
  • "owner": {
    • "id": 1,
    • "email": "[email protected]",
    • "firstName": "Sally",
    • "lastName": "Smith",
    • "createdAt": "2025-07-01T16:45:55.246Z",
    • "updatedAt": "2025-07-01T16:45:55.246Z",
    • "jobTitle": "CEO",
    • "avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
    • "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
    • "roles": [
      • "ROLE",
      • "ANOTHER_ROLE"
      ],
    • "backgroundChecks": [
      • {
        • "id": 0,
        • "userId": 0,
        • "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",
        • "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"
        }
      ],
    • "documents": [],
    • "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"
          },
        • "email": "[email protected]",
        • "secondaryEmail": "[email protected]",
        • "firstName": "John",
        • "lastName": "Doe",
        • "startedAt": "Thu Aug 14 2025",
        • "separatedAt": "Thu Aug 14 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"
        }
      ]
    },
  • "notes": "string",
  • "assetReferenceType": "PERSONNEL",
  • "associatedId": "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",
    • "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,
    • "isDeviceCompliant": false,
    • "complianceChecks": [ ],
    • "identifiers": [ ],
    • "documents": [ ],
    • "screenLockTime": 30,
    • "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"
        ]
      },
    • "encryptionEnabled": false,
    • "encryptionExplanation": "No encryption provided",
    • "firewallEnabled": true,
    • "firewallExplanation": "{}",
    • "asset": {
      • "id": 1,
      • "name": "MacBook Pro - Space Black 16-inch",
      • "description": "MacBook Pro Space Black - with 16-inch Liquid Retina XDR display",
      • "assetType": "PHYSICAL",
      • "assetProvider": "AGENT",
      • "approvedAt": "2025-07-01T16:45:55.246Z",
      • "removedAt": "2025-07-01T16:45:55.246Z",
      • "company": "Acme, Inc",
      • "notes": "string",
      • "assetReferenceType": "PERSONNEL",
      • "uniqueId": "C02T6CDJGTFL",
      • "createdAt": "2025-07-01T16:45:55.246Z",
      • "updatedAt": "2025-07-01T16:45:55.246Z",
      • "externalId": "i-0c844e3b433e4e3f",
      • "externalOwnerId": "account-353"
      },
    • "userId": 1,
    • "personnelId": 1,
    • "externalId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd"
    },
  • "externalId": "i-0c844e3b433e4e3f",
  • "externalOwnerId": "account-353",
  • "customFields": [
    • {
      • "customFieldId": 1,
      • "name": "Stakeholders",
      • "value": "Security & IT"
      }
    ]
}
Remove Asset
Remove a virtual or manually-added Asset. This is an unrecoverable operation.


🔒 Requires Assets: Delete Asset permission.


Securitybearer 
Request 
path Parameters
assetId
required
number
 
Responses 
204
No Content


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/{assetId}
Request samples 
Response samples 
application/json
{
  • "name": "string",
  • "statusCode": 0,
  • "message": "string",
  • "code": 0,
  • "debugInfo": {
    • "name": "string",
    • "message": "string",
    • "stack": "string"
    }
}