---
title: "Delete device evidence"
method: POST
path: "/vis/v2/orgs/{orgId}/devices/delete/submit"
tags: ["Device"]
---

# Delete device evidence

`POST /vis/v2/orgs/{orgId}/devices/delete/submit`

## Request

- Base URL: `https://api.flexera.com`
- URL: `https://api.flexera.com/vis/v2/orgs/{orgId}/devices/delete/submit`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/flexera/apis/it-visibility-api/docs/vis/v2/orgs/:orgId/devices/delete/submit/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `orgId` integer, required: The unique identifier for the organization

## Request body

- EstimateDeleteRequestBody
  - `datasourceSelectors` DeviceDatasourceSelection[]: Optional datasource selectors. A datasource is included when it matches any selector. Omit this attribute to include all datasources associated with the specified devices.
    - `field` 'id' | 'name' | 'type', required: Datasource property to compare: id for the datasource ID, name for the datasource name, or type for the datasource type
    - `value` string, required: Exact value that the selected datasource property must match
  - `deviceIds` string[], 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.

## Response `202`

Accepted response.

- FlexeraVisDeviceDeletionSummary[]
  - `count` integer, required: The number of devices whose evidence is selected
  - `datasourceId` string, required: The ID of the datasource
  - `datasourceName` string, required: The name of the datasource
  - `datasourceType` string, required: The type of the datasource
  - `kind` 'vis:device-deletion-summary', required: The resource's type

## Other responses

- `400`: bad_request: Bad Request response.
- `401`: unauthorized: Unauthorized response.
- `403`: forbidden: Forbidden response.
- `429`: too_many_requests: Too Many Requests response.
- `500`: internal_error: Internal Server Error response.
- `502`: bad_gateway: Bad Gateway response.

## Changes

- **2026-11-06** `cf08a0af5097`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/flexera/apis/it-visibility-api/changes/vis/v2/orgs/:orgId/devices/delete/submit/post.md)

---

[API](https://skmtc.dev/flexera/apis/it-visibility-api.md) - [All operations](https://skmtc.dev/flexera/apis/it-visibility-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flexera/apis/it-visibility-api/revisions/cf08a0af5097?raw)