Skip to main content
POST
/
api
/
ext-v1
/
deviceAssignment
/
unassignDeviceFromOwner
curl -X POST https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDeviceFromOwner \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "deviceIdentifier": "SN-12345-ABCDE",
    "customerEmail": "john.doe@example.com"
  }'

{
  "success": true,
  "message": "Device successfully unassigned from customer",
  "customerId": "cust_a1b2c3d4e5f6",
  "deviceIdentifier": "SN-12345-ABCDE",
  "devicesRemaining": ["SN-67890-FGHIJ"]
}

​
Overview

Removes the device-to-customer assignment. Both records remain in the system; only the association is removed.
After unassignment, device telemetry will no longer route to this customer. Reassign to new owner if device is still active.

​
Authentication

​
x-api-key
string
required
Your organization’s API key

​
Request Body

​
deviceIdentifier
string
required
The unique identifier for the device (e.g., serial number, MAC address)
​
customerEmail
string
required
The email address of the customer to unassign the device from

​
Response

​
success
boolean
Indicates if the operation was successful
​
message
string
Description of the operation result
​
customerId
string
The unique identifier of the customer
​
deviceIdentifier
string
The device identifier that was unassigned
​
devicesRemaining
array
Array of device identifiers still assigned to this customer after the unassignment

​
Examples

​
Request

curl -X POST https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDeviceFromOwner \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "deviceIdentifier": "SN-12345-ABCDE",
    "customerEmail": "john.doe@example.com"
  }'

​
Response

{
  "success": true,
  "message": "Device successfully unassigned from customer",
  "customerId": "cust_a1b2c3d4e5f6",
  "deviceIdentifier": "SN-12345-ABCDE",
  "devicesRemaining": ["SN-67890-FGHIJ"]
}

curl -X POST https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDeviceFromOwner \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "deviceIdentifier": "SN-12345-ABCDE",
    "customerEmail": "john.doe@example.com"
  }'

{
  "success": true,
  "message": "Device successfully unassigned from customer",
  "customerId": "cust_a1b2c3d4e5f6",
  "deviceIdentifier": "SN-12345-ABCDE",
  "devicesRemaining": ["SN-67890-FGHIJ"]
}

​
Status Codes

CodeDescription
200Device successfully unassigned from customer
400Invalid request (missing required fields, invalid email format, or device not assigned to customer)
401Invalid or missing API key
404Customer not found in your organization
500Internal server error

​
Notes

  • Email format is validated before processing
  • Non-destructive: customer and device records persist
  • Response includes devicesRemaining array for tracking

​
Common Use Cases

  • Device returns/replacements: Stop routing telemetry to this customer
  • Ownership transfer: Unassign from old owner, then assign to new owner
  • Account cleanup: Remove inactive devices from customer accounts
Transfer Pattern: Unassign from old owner → Assign to new owner. See Assign Device.