---
updatedAt: 2026-07-02T14:53:06.000Z
---

# Deletes Computers

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "BeyondTrust PM Cloud Management API - Version 3",
    "description": "BeyondTrust PM Cloud Management API - Version 3",
    "version": "v3"
  },
  "servers": [
    {
      "url": "https://{example.com}/management-api"
    }
  ],
  "paths": {
    "/v3/Computers": {
      "delete": {
        "tags": [
          "Computers"
        ],
        "summary": "Deletes Computers",
        "requestBody": {
          "description": "Request containing data to filter Computers to be removed",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ComputersRemoveRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ComputersRemoveRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ComputersRemoveRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          },
          "201": {
            "description": "Created",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              },
              "text/json": {
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "423": {
            "description": "Client Error",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": [],
            "oauth2": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "AgentHostType": {
        "enum": [
          "Undefined",
          "MicrosoftWindows",
          "AppleMacOS",
          "Linux"
        ],
        "type": "string",
        "nullable": true
      },
      "ComputerFilterModel": {
        "type": "object",
        "properties": {
          "computerId": {
            "type": "string",
            "description": "The Id of the Computer(Guid format), for example - 59A00329-87AC-49EC-BC2C-9B9E26F05185",
            "format": "uuid",
            "nullable": true
          },
          "host": {
            "type": "string",
            "description": "The host name of the Computer, for example - Computer1",
            "nullable": true
          },
          "hostType": {
            "$ref": "#/components/schemas/AgentHostType"
          },
          "agentVersion": {
            "type": "string",
            "description": "The agent version of the Computer, example - 5.6.126.0",
            "nullable": true
          },
          "adapterVersion": {
            "type": "string",
            "description": "The adapter version of the Computer, example - 20.5.195.0",
            "nullable": true
          },
          "packageManagerVersion": {
            "type": "string",
            "description": "The Package Manager version on the Computer, example - 20.5.195.0",
            "nullable": true
          },
          "authorisationState": {
            "type": "string",
            "description": "The state of the Computer, example - Authorised, Pending",
            "nullable": true
          },
          "lastConnected": {
            "$ref": "#/components/schemas/DateFilterModel"
          },
          "policyRevisionStatus": {
            "type": "string",
            "description": "Policy Revision Status, example - AwaitingLatestPolicy",
            "nullable": true
          },
          "policyId": {
            "type": "string",
            "description": "Policy Id, example - 59A00329-87AC-49EC-BC2C-9B9E26F05185",
            "format": "uuid",
            "nullable": true
          },
          "policyName": {
            "type": "string",
            "description": "Policy Name (Assigned Policy to Group/Endpoint), example - Policy1",
            "nullable": true
          },
          "hostPolicyName": {
            "type": "string",
            "description": "Host Policy Name (Current Policy on Endpoint), example - Policy1",
            "nullable": true
          },
          "groupId": {
            "type": "string",
            "description": "Group Id, example - 59A00329-87AC-49EC-BC2C-9B9E26F05185",
            "format": "uuid",
            "nullable": true
          },
          "groupName": {
            "type": "string",
            "description": "Group Name, example - Group1",
            "nullable": true
          },
          "os": {
            "$ref": "#/components/schemas/OS"
          },
          "domain": {
            "type": "string",
            "description": "Domain Name, example - BeyondTrust",
            "nullable": true
          },
          "created": {
            "$ref": "#/components/schemas/DateFilterModel"
          },
          "duplicateCount": {
            "$ref": "#/components/schemas/CountRange"
          },
          "connectionStatus": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "ConnectionStatus",
            "nullable": true
          },
          "daysDisconnected": {
            "type": "integer",
            "description": "DaysDisconnected",
            "format": "int32",
            "nullable": true
          },
          "daysSinceArchived": {
            "type": "integer",
            "description": "DaysSinceArchived",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ComputersRemoveRequest": {
        "type": "object",
        "properties": {
          "computerIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "List of Computers identifiers to be removed (optional when allComputers is true, otherwise its required)",
            "nullable": true
          },
          "excludedComputerIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "List of Computers identifiers to be excluded from the deletion list. \r\n\r\nexcluded computers Ids will only be applicable when \"allComputers\" is set to false.",
            "nullable": true
          },
          "filter": {
            "$ref": "#/components/schemas/ComputerFilterModel"
          },
          "allComputers": {
            "type": "boolean",
            "description": "Flag for all Computers matching BT.Common.ManagementApi.Computer.ComputerFilterModel and ExcludedComputerIds should be removed"
          }
        },
        "additionalProperties": false,
        "description": "Request to remove Computer(s)"
      },
      "CountRange": {
        "type": "object",
        "properties": {
          "min": {
            "maximum": 4294967295,
            "minimum": 0,
            "type": "integer",
            "description": "Min Value of CountRange, example - 1,2,3",
            "format": "int64"
          },
          "max": {
            "maximum": 4294967295,
            "minimum": 0,
            "type": "integer",
            "description": "Max Value of CountRange, example - 1,2,3",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "DateFilterModel": {
        "type": "object",
        "properties": {
          "dates": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "date-time",
              "nullable": true
            },
            "description": "Valid date formats for filter - 2020-12-24, 2020-12-24 19:09:47, 2020-12-24 19:09:47.6816562, 2020-12-24 19:09:47.6816562 +00:00",
            "nullable": true
          },
          "selectionMode": {
            "$ref": "#/components/schemas/DateSelectionMode"
          }
        },
        "additionalProperties": false,
        "description": "DateFilter to specify Dates to be filtered"
      },
      "DateSelectionMode": {
        "enum": [
          "Single",
          "Multiple",
          "Range"
        ],
        "type": "string",
        "description": "Date Selection Mode for filter"
      },
      "OS": {
        "enum": [
          "Windows",
          "Mac"
        ],
        "type": "string",
        "nullable": true
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": {}
      }
    },
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://sneakpeek-services.epm.bt3ng.com/oauth/connect/token",
            "scopes": {
              "urn:management:api": "Management API scope"
            }
          }
        }
      }
    }
  },
  "x-readme": {}
}
```