Manually add a new asset to the account
Record created!
Malformed data and/or validation errors
Invalid Authorization
You must pay to activate this feature
You are not allowed to perform this action
Record Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "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"
}
{- "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",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "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",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "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"
}
], - "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,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupLabel": "Everyone"
}, - "hasIdp": true,
- "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",
- "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"
}