Skip to main content
DELETE
Delete an asset

Overview

Remove an asset from your inventory. This is a soft delete—the asset is marked as unavailable rather than permanently removed, preserving historical data for reporting and auditing.
Assets that are currently assigned to active subscriptions cannot be deleted. End or cancel the subscription first.

What Happens When You Delete

  1. Asset status changes to unavailable
  2. Asset removed from available inventory queries
  3. Historical records preserved (subscriptions, payments)
  4. Cannot be assigned to new subscriptions

Common Use Cases

  • Sold Assets: Device was sold to customer (buyout)
  • Retired Inventory: Device too old or damaged for reuse
  • Lost/Stolen: Device cannot be recovered
  • Inventory Cleanup: Remove test or duplicate entries

Prerequisites

Before deleting:
  1. No active subscriptions using this asset
  2. Asset returned (if previously rented)

Example: Delete with Reason

Alternative: Mark Unavailable

If you want to preserve the asset record but remove from active inventory, consider updating status instead:
This keeps the asset fully visible in reports while preventing new assignments.

Recovering Deleted Assets

Since deletion is a soft delete, you can reactivate assets:

Error Handling

Authorizations

Authorization
string
header
required

API key obtained from FlexPortal dashboard

Headers

Tenant-ID
string
required

Your tenant identifier

Path Parameters

serialNumber
string
required

The asset serial number

Response

Asset deleted

success
enum<boolean>
required
Available options:
true
message
string
required
serialNumber
string
required