Remove an asset by asset ID

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

Securitybearer
Request
path Parameters
id
required
number
Responses
200
400

Malformed data and/or validation errors

401

Invalid Authorization

402

Response Code 402

You must pay to activate this feature

403

You are not allowed to perform this action

404

Record Not Found

412

Response Code: 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": [],
          • "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"
}