FLflexera
Device

Delete device evidence

Submits a request to delete device evidence for the specified device IDs.

A datasource is included if it matches any datasource selector. If no datasource selectors are provided, evidence from every datasource associated with the specified devices is included.

Submitting a deletion request does not guarantee that all selected evidence will be deleted because inventory may change while the request is processed. If a device remains active in the environment, its evidence may reappear after new inventory data is collected.

Repeating a deletion request is allowed and does not return an error when the selected evidence has already been deleted.

Client guidance

  • Submit no more than 500 unique device IDs per request. This recommendation is not enforced, but larger requests provide no processing benefit and may increase latency or timeout risk.
  • Split larger workloads into batches and process one batch at a time per organization. Use the same datasource selectors for every batch in one logical operation.
  • There is currently no specific concurrency limit or hard cap in place. We recommend that customers test and tune their request volume based on their network conditions, performance requirements, and business needs.
  • The API does not automatically retry failed deletion requests. Clients must not automatically retry timed-out requests because inventory may change and the original deletion may already have been submitted.
post/vis/v2/orgs/{orgId}/devices/delete/submit

Request

Path parameters

orgIdinteger required

The unique identifier for the organization

Example:100

Request body

deviceIdsstring[] required

Device IDs whose evidence should be included. Send no more than 500 unique IDs per request; this recommendation is not enforced by the API.

Example request

{
  "datasourceSelectors": [
    {
      "field": "id",
      "value": "a8d416e5-7212-4a9a-93f3-0b8602ad06f4"
    }
  ],
  "deviceIds": [
    "4e0e3471-ccbc-41c7-a21e-c384f2eb5669"
  ]
}

Response

Accepted response.

countinteger required

The number of devices whose evidence is selected

datasourceIdstring required

The ID of the datasource

datasourceNamestring required

The name of the datasource

datasourceTypestring required

The type of the datasource

kind'vis:device-deletion-summary' required

The resource's type

Example response

[
  {
    "count": 42,
    "datasourceId": "a8d416e5-7212-4a9a-93f3-0b8602ad06f4",
    "datasourceName": "ServiceNow Import",
    "datasourceType": "ServiceNow",
    "kind": "vis:device-deletion-summary"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.