Skip to main content

Computers

API docs by Redocly

SAM: Computers (1.0.0)

Download OpenAPI specification:Download

URL: https://www.flexera.com

API for interacting with computers.

Computer application metering

Get application metering

Returns a collection of metric tracking data for computer applications.

Authorizations:
BearerAuth
query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get application metering by computer

Returns a collection of metric tracking data for applications on the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer applications

Get computer's applications

Returns a collection of applications for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get computer application's details

Returns the details of the given computer application.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

applicationid
required
string

The unique ID of the application.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "computerId": "c1d617ff-2104-411c-9c20-682017a9fefd",
  • "applicationId": "c1d617ff-2104-411c-9c20-682017a9fefd",
  • "bundleApplicationId": "c1d617ff-2104-411c-9c20-682017a9fefd",
  • "firstDiscovered": "2024-03-24T12:52:20Z",
  • "firstUsed": "2024-03-24T12:52:20Z",
  • "lastUsed": "2024-03-24T12:52:20Z",
  • "usedCount": 10,
  • "usedUser": 10,
  • "usedMinutes": 10,
  • "usedDays": 10,
  • "isInstalled": true,
  • "isOEM": true,
  • "isMSDN": true,
  • "isVirtual": true,
  • "isOverridden": true,
  • "packageGUID": "640b16bb-447f-430f-87ee-49bfe940e308",
  • "isRecognized": true,
  • "isRegistry": true,
  • "averageUsedTime": "2024-03-24T12:52:20Z",
  • "unbundled": true
}

Get computer applications

Returns a collection of applications.

Authorizations:
BearerAuth
query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get application usage data

Returns a collection of application usage data.

Authorizations:
BearerAuth
query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get application user usage

Returns a collection of users' application usage data.

Authorizations:
BearerAuth
query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get application usage summaries

Returns a collection of application usage summaries.

Authorizations:
BearerAuth
query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer contracts

Get computer's contracts

Returns a collection of contracts for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer costs

Get computer's costs

Returns the details of a computer's costs.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "computerId": "4f2403da-3ab5-48f8-9114-73304cfeb017",
  • "vendor": "Dell Inc.",
  • "purchaseDate": "2024-03-24T12:52:20Z",
  • "purchasePrice": 2521.32,
  • "purchaseValueBase": 2500.32,
  • "purchaseCurrency": "EUR",
  • "invoiceReference": "2024/03/63729P",
  • "totalCostOfInstalledApplications": 1452.28,
  • "totalCost": 3973.6
}

Computer display adapter

Get computer's display adapters

Returns a collection of display adapters for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "computerId": "66a6b2b7-2ff1-403f-add3-60ed14a0233a",
  • "name": "NVIDIA T1200 Laptop GPU",
  • "currentResolution": "1920 x 1200",
  • "maxResolution": "2560x1440",
  • "isUpdated": true
}

Computer drives

Get computer's drives

Returns a collection of hard drives for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get computer optical drives

Returns a collection of optical drives for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer environment variables

Get computer's environment variables

Returns a collection of environment variable for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get computer environment variables

Returns a collection of computer environment variables.

Authorizations:
BearerAuth
query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer hardware

Get computer's hardware details

Returns the details of the hardware for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "computerId": "990b4de8-f11f-4904-9e86-d8a435835574",
  • "processorCount": 2,
  • "coreCount": 8,
  • "processorType": "11th Gen Intel Core i7-1185G7 @ 3.00GHz (3.00 GHz)",
  • "processorSpeed": 2995,
  • "memorySlots": 8,
  • "memorySlotsAvailable": 2,
  • "physicalMemory": 16384,
  • "systemDiskSpace": 957534,
  • "systemDiskSpaceAvailable": 552150,
  • "totalDiskSpace": 957534,
  • "totalDiskSpaceAvailable": 552150,
  • "totalDiskSpaceUsed": 405384,
  • "socketCount": 2,
  • "isSocketCountManualOverrideEnabled": true,
  • "chipModulesPerProcessor": 2,
  • "processorManufacturer": "Intel",
  • "logicalProcessorCount": 12
}

Computer logical disks

Get computer's logical disks

Returns a collection of logical disks for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer logon history

Get computer's logon history

Returns a collection of logon history for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get user's logon history on all computers

Returns a collection of computer logon histories for the given user.

Authorizations:
BearerAuth
path Parameters
userid
required
string

The unique ID of the user.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get user's logon history on a computer

Returns the details of a computer's logon history for the given user.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

userid
required
string

The unique ID of the user.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "computerId": "0d779524-e2cf-4636-a701-65ce7c3f5763",
  • "userId": "c5a87d81-b035-4b38-88f8-13fabd790764",
  • "lastLogon": "2024-03-24T12:52:20Z",
  • "logonCount": 10
}

Computer monitors

Get computer's monitors

Returns a collection of monitors for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "computerId": "636d9b38-1afd-4b96-8998-01d475cc0f36",
  • "name": "Intel UHD Graphics",
  • "maxResolution": "2560 x 1600",
  • "isUpdated": true
}

Computer network adapters

Get computer's network adapters

Returns a collection of network adapters for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get all network adapters

Returns a collection of network adapters.

Authorizations:
BearerAuth
query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer processors

Get computer's processors

Returns a collection of processors for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Get processor socket details

Returns the details of the processor sockets for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "computerId": "cf5be788-06be-4496-91b0-bfaa8c239e96",
  • "manufacturer": "Intel",
  • "model": "LGA 1151",
  • "socketCount": 2
}

Computer registries

Get computer's registries

Returns a collection of registries for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer remote clients

Get computer's remote clients

Returns a collection of remote clients for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computer virtual machines

Get computer's virtual machines

Returns a collection of virtual machines for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the virtual machine.

query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 100

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Computers

Bulk update status of computers

Allows updating the status of multiple computers in bulk.

Request Body schema: application/json
required
scope
required
string
Value: "Only"

Scope for the bulk status update. Must be 'Only'.

ids
required
Array of strings <uuid> [ items <uuid > ]

List of computer IDs to update.

required
object (BulkUpdateComputerStatusBody)
status
string
Enum: "Active" "Inactive" "Quarantined"

Target status value for the bulk update.

Responses

Request samples

Content type
application/json
{
  • "scope": "Only",
  • "ids": [
    ],
  • "body": {
    }
}

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "message": "string",
  • "processedCount": 0,
  • "skippedCount": 0
}

Get computer details

Returns the details of the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "id": "5043cc04-3ef2-4882-a3be-8d08b4f402c7",
  • "scanIdentifier": "MAC-C02GD9DUML7H",
  • "hostName": "AM21-S42MONITOR",
  • "domain": "APAC",
  • "lastScanDate": "2024-03-24T12:52:20Z",
  • "biosSerialNumber": "43-01-10-TX",
  • "biosVersion": "1.26.0",
  • "biosDate": "2024-03-24T12:52:20Z",
  • "manufacturer": "Lenovo",
  • "manufacturerWebsite": "https://www.lenovo.com",
  • "model": "T480s",
  • "isPortable": true,
  • "infoTransferDate": "2024-03-24T12:52:20Z",
  • "clientInstallDate": "2024-03-24T12:52:20Z",
  • "clientVersion": "6.14.3",
  • "clientSiteName": "snow",
  • "clientConfigurationName": "SnowAtlas",
  • "scannerVersion": "7.0.0",
  • "quarantineDate": "2024-03-24T12:52:20Z",
  • "isQuarantineManagementDisabled": true,
  • "operatingSystem": "Microsoft Windows 11 Pro",
  • "operatingSystemId": "c27c14a7-dcec-4f8e-b08e-cdb7263b5378",
  • "operatingSystemServicePack": "SP1",
  • "operatingSystemSerialNumber": "V6E3X-S6J5H-L5F5P-M4M2Y",
  • "ipAddress": "10.20.20.77",
  • "isVirtual": true,
  • "hostComputerId": "037e6448-6ad3-4279-800d-010677485bbb",
  • "siblingComputerId": "687e2c50-6900-463a-b470-8c12e3677be8",
  • "isUpdated": true,
  • "is64bit": true,
  • "isServer": true,
  • "hypervisorName": "VMware Virtual Platform",
  • "isVdi": true,
  • "processorValueUnit": 32,
  • "reportingDate": "2024-03-24T12:52:20Z",
  • "architecture": "64-bit",
  • "organizationId": "293cf227-bf7f-4919-b664-791f3f49e1ef",
  • "status": "Active",
  • "isAutoEditingDisabled": true,
  • "purchaseDate": "2024-03-24T12:52:20Z",
  • "purchaseValue": 2461.32,
  • "purchaseCurrency": "EUR",
  • "purchaseValueBase": 2500.32,
  • "invoiceReference": "2024/03/63729P",
  • "notes": "Purchased in a set with printer",
  • "securityCode": "A563Z",
  • "updatedDate": "2024-03-24T12:52:20Z",
  • "isIncludedInWindowsServerRequirement": true,
  • "mostRecentUser": "77f8f11f-e4f8-4bed-8e44-b78d66244302",
  • "mostFrequentUser": "f2c35e21-aba4-4e0d-8c14-f3033e7b1fb7",
  • "vendor": "Dell Inc.",
  • "processorCount": 2,
  • "coreCount": 8
}

Delete computer

Removes the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

Update computer attributes

Modifies a computer by adding or updating the specified attributes.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

Request Body schema: application/json
purchaseDate
string or null <date-time>

The date on which the computer was purchased.

purchaseValue
number or null <decimal>

The amount for which the computer was purchased.

purchaseCurrency
string or null

The currency in which the computer was purchased.

vendor
string or null

The vendor of the computer.

invoiceReference
string or null

The invoice reference for the purchase of the computer.

statusCode
string or null

The status of the computer.

organizationId
string or null <guid>

The unique ID of the organization to which the computer belongs.

isQuarantineManagementDisabled
boolean or null

true if the computer has quarantine management disabled; otherwise, false.

isAutoEditingDisabled
boolean or null

true if the auto editing is disabled for the computer; otherwise, false.

socketCount
integer or null <int32>

The number of sockets in the computer.

hostComputerId
string or null <guid>

The unique ID of the host computer if present.

siblingComputerId
string or null <guid>

The unique ID of the sibling computer if present.

isVirtual
boolean or null

true if the computer is virtual; otherwise, false.

isSocketCountManualOverrideEnabled
boolean or null

true if the socket count manual override of the computer is enabled; otherwise, false.

chipModulesPerProcessor
integer or null <int32>

The number of chip modules per processor.

notes
string or null

The notes associated with the purchase of the computer.

securityCode
string or null

The security code for the computer.

processorValueUnit
integer or null <int32>

The processor value unit of the computer.

biosSerialNumber
string or null

The BIOS serial number of the computer.

Responses

Request samples

Content type
application/json
{
  • "purchaseDate": "2024-03-24T12:52:20Z",
  • "purchaseValue": 2461.32,
  • "purchaseCurrency": "EUR",
  • "vendor": "Dell",
  • "invoiceReference": "2024/03/63729P",
  • "statusCode": "Active",
  • "organizationId": "293cf227-bf7f-4919-b664-791f3f49e1ef",
  • "isQuarantineManagementDisabled": true,
  • "isAutoEditingDisabled": false,
  • "socketCount": 2,
  • "hostComputerId": "8FD97CF1-FB71-469B-ACEA-39314EC26213",
  • "siblingComputerId": "f2c35e21-aba4-4e0d-8c14-f3033e7b1fb7",
  • "isVirtual": false,
  • "isSocketCountManualOverrideEnabled": true,
  • "chipModulesPerProcessor": 2,
  • "notes": "Purchased in a set with printer",
  • "securityCode": "A563Z",
  • "processorValueUnit": 32,
  • "biosSerialNumber": "43-01-10-TX"
}

Response samples

Content type
application/json
{
  • "error": {
    }
}

Get computers

Returns a collection of computers.

Authorizations:
BearerAuth
query Parameters
page_number
integer >= 1
Default: 1

The page number.

page_size
integer >= 1
Default: 25

The maximum number of items in the response.

filter
string

The fields which you can use to filter the results. Format of the query string parameter:

?filter=<filter name> <operator> <value>
Filter name Description Data type Example

For more information on the available operators and which data types those operators work on, see Filter API call results.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "items": [
    ],
  • "pagination": {
    }
}

Archive computer

Archives the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

Update Disable auto editing settings for a computer

Modifies Disable auto editing settings for the given computer.

path Parameters
id
required
string

The unique ID of the computer.

Request Body schema: application/json-patch+json
Array
One of
path
required
string

A JSON Pointer path.

value
required
any

The value to add, replace, or test.

op
required
string
Enum Description
add

Adds a value to an object or inserts it into an array.

replace

Replaces a value.

test

Tests that the specified value is set in the document.

The operation to perform.

Responses

Request samples

Content type
application/json-patch+json
{
  • "0": {
    }
}

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "id": "5043cc04-3ef2-4882-a3be-8d08b4f402c7",
  • "scanIdentifier": "MAC-C02GD9DUML7H",
  • "hostName": "AM21-S42MONITOR",
  • "domain": "APAC",
  • "lastScanDate": "2024-03-24T12:52:20Z",
  • "biosSerialNumber": "43-01-10-TX",
  • "biosVersion": "1.26.0",
  • "biosDate": "2024-03-24T12:52:20Z",
  • "manufacturer": "Lenovo",
  • "manufacturerWebsite": "https://www.lenovo.com",
  • "model": "T480s",
  • "isPortable": true,
  • "infoTransferDate": "2024-03-24T12:52:20Z",
  • "clientInstallDate": "2024-03-24T12:52:20Z",
  • "clientVersion": "6.14.3",
  • "clientSiteName": "snow",
  • "clientConfigurationName": "SnowAtlas",
  • "scannerVersion": "7.0.0",
  • "quarantineDate": "2024-03-24T12:52:20Z",
  • "isQuarantineManagementDisabled": true,
  • "operatingSystem": "Microsoft Windows 11 Pro",
  • "operatingSystemId": "c27c14a7-dcec-4f8e-b08e-cdb7263b5378",
  • "operatingSystemServicePack": "SP1",
  • "operatingSystemSerialNumber": "V6E3X-S6J5H-L5F5P-M4M2Y",
  • "ipAddress": "10.20.20.77",
  • "isVirtual": true,
  • "hostComputerId": "037e6448-6ad3-4279-800d-010677485bbb",
  • "siblingComputerId": "687e2c50-6900-463a-b470-8c12e3677be8",
  • "isUpdated": true,
  • "is64bit": true,
  • "isServer": true,
  • "hypervisorName": "VMware Virtual Platform",
  • "isVdi": true,
  • "processorValueUnit": 32,
  • "reportingDate": "2024-03-24T12:52:20Z",
  • "architecture": "64-bit",
  • "organizationId": "293cf227-bf7f-4919-b664-791f3f49e1ef",
  • "status": "Active",
  • "isAutoEditingDisabled": true,
  • "purchaseDate": "2024-03-24T12:52:20Z",
  • "purchaseValue": 2461.32,
  • "purchaseCurrency": "EUR",
  • "purchaseValueBase": 2500.32,
  • "invoiceReference": "2024/03/63729P",
  • "notes": "Purchased in a set with printer",
  • "securityCode": "A563Z",
  • "updatedDate": "2024-03-24T12:52:20Z",
  • "isIncludedInWindowsServerRequirement": true,
  • "mostRecentUser": "77f8f11f-e4f8-4bed-8e44-b78d66244302",
  • "mostFrequentUser": "f2c35e21-aba4-4e0d-8c14-f3033e7b1fb7",
  • "vendor": "Dell Inc.",
  • "processorCount": 2,
  • "coreCount": 8
}

Update Organization for a computer

Modifies Organization for the given computer.

Authorizations:
BearerAuth
path Parameters
id
required
string

The unique ID of the computer.

Request Body schema: application/json-patch+json
Array
One of
path
required
string

A JSON Pointer path.

value
required
any

The value to add, replace, or test.

op
required
string
Enum Description
add

Adds a value to an object or inserts it into an array.

replace

Replaces a value.

test

Tests that the specified value is set in the document.

The operation to perform.

Responses

Request samples

Content type
application/json-patch+json
{
  • "0": {
    }
}

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "id": "5043cc04-3ef2-4882-a3be-8d08b4f402c7",
  • "scanIdentifier": "MAC-C02GD9DUML7H",
  • "hostName": "AM21-S42MONITOR",
  • "domain": "APAC",
  • "lastScanDate": "2024-03-24T12:52:20Z",
  • "biosSerialNumber": "43-01-10-TX",
  • "biosVersion": "1.26.0",
  • "biosDate": "2024-03-24T12:52:20Z",
  • "manufacturer": "Lenovo",
  • "manufacturerWebsite": "https://www.lenovo.com",
  • "model": "T480s",
  • "isPortable": true,
  • "infoTransferDate": "2024-03-24T12:52:20Z",
  • "clientInstallDate": "2024-03-24T12:52:20Z",
  • "clientVersion": "6.14.3",
  • "clientSiteName": "snow",
  • "clientConfigurationName": "SnowAtlas",
  • "scannerVersion": "7.0.0",
  • "quarantineDate": "2024-03-24T12:52:20Z",
  • "isQuarantineManagementDisabled": true,
  • "operatingSystem": "Microsoft Windows 11 Pro",
  • "operatingSystemId": "c27c14a7-dcec-4f8e-b08e-cdb7263b5378",
  • "operatingSystemServicePack": "SP1",
  • "operatingSystemSerialNumber": "V6E3X-S6J5H-L5F5P-M4M2Y",
  • "ipAddress": "10.20.20.77",
  • "isVirtual": true,
  • "hostComputerId": "037e6448-6ad3-4279-800d-010677485bbb",
  • "siblingComputerId": "687e2c50-6900-463a-b470-8c12e3677be8",
  • "isUpdated": true,
  • "is64bit": true,
  • "isServer": true,
  • "hypervisorName": "VMware Virtual Platform",
  • "isVdi": true,
  • "processorValueUnit": 32,
  • "reportingDate": "2024-03-24T12:52:20Z",
  • "architecture": "64-bit",
  • "organizationId": "293cf227-bf7f-4919-b664-791f3f49e1ef",
  • "status": "Active",
  • "isAutoEditingDisabled": true,
  • "purchaseDate": "2024-03-24T12:52:20Z",
  • "purchaseValue": 2461.32,
  • "purchaseCurrency": "EUR",
  • "purchaseValueBase": 2500.32,
  • "invoiceReference": "2024/03/63729P",
  • "notes": "Purchased in a set with printer",
  • "securityCode": "A563Z",
  • "updatedDate": "2024-03-24T12:52:20Z",
  • "isIncludedInWindowsServerRequirement": true,
  • "mostRecentUser": "77f8f11f-e4f8-4bed-8e44-b78d66244302",
  • "mostFrequentUser": "f2c35e21-aba4-4e0d-8c14-f3033e7b1fb7",
  • "vendor": "Dell Inc.",
  • "processorCount": 2,
  • "coreCount": 8
}