Unassign Devices from Owner

POST

api

ext-v1

deviceAssignment

unassignDevicesFromOwner

curl -X POST https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerEmail": "john.doe@example.com",
    "deviceIdentifiers": ["SN-001", "SN-002"]
  }'

const response = await fetch(
  'https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner',
  {
    method: 'POST',
    headers: {
      'x-api-key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      customerEmail: 'john.doe@example.com',
      deviceIdentifiers: ['SN-001', 'SN-002']
    })
  }
);

const result = await response.json();

import requests

response = requests.post(
    'https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner',
    headers={
        'x-api-key': 'your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'customerEmail': 'john.doe@example.com',
        'deviceIdentifiers': ['SN-001', 'SN-002']
    }
)

result = response.json()

{
  "success": true,
  "message": "Successfully unassigned 1 device(s) from customer",
  "customerId": "cust_abc123",
  "unassignedDevices": ["SN-001"],
  "skipped": ["SN-002"],
  "devicesRemaining": ["SN-003"]
}

{
  "success": true,
  "message": "Successfully unassigned 2 device(s) from customer",
  "customerId": "cust_abc123",
  "unassignedDevices": ["SN-001", "SN-002"],
  "skipped": [],
  "devicesRemaining": []
}

{
  "error": "Customer not found for this organization"
}

{
  "error": "Invalid input: customerEmail and deviceIdentifiers are required"
}

Overview

Removes multiple device-to-customer assignments in a single request. This is the bulk variant for unassigning devices — use this when removing several devices from the same customer at once. Both the device and customer records remain in the system; only the associations are removed.

After unassignment, device telemetry will no longer route to this customer. Reassign devices to a new owner if they are still active.

Authentication

string

required

Your organization’s API key

Request Body

string

required

The email address of the customer to unassign devices from. Must be a valid email format.

array

required

Array of device identifiers (e.g., serial numbers, MAC addresses) to unassign. Must be a non-empty array.

Response

boolean

Indicates if the operation was successful

string

Description of the operation result

string

The unique identifier of the customer

array

Array of device identifier strings that were successfully unassigned

array

Array of device identifier strings that were not assigned to this customer (no-op)

array

Full list of device identifiers still assigned to the customer after the operation

Examples

Bulk Unassignment

curl -X POST https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerEmail": "john.doe@example.com",
    "deviceIdentifiers": ["SN-001", "SN-002"]
  }'

const response = await fetch(
  'https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner',
  {
    method: 'POST',
    headers: {
      'x-api-key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      customerEmail: 'john.doe@example.com',
      deviceIdentifiers: ['SN-001', 'SN-002']
    })
  }
);

const result = await response.json();

import requests

response = requests.post(
    'https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner',
    headers={
        'x-api-key': 'your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'customerEmail': 'john.doe@example.com',
        'deviceIdentifiers': ['SN-001', 'SN-002']
    }
)

result = response.json()

Response

{
  "success": true,
  "message": "Successfully unassigned 1 device(s) from customer",
  "customerId": "cust_abc123",
  "unassignedDevices": ["SN-001"],
  "skipped": ["SN-002"],
  "devicesRemaining": ["SN-003"]
}

{
  "success": true,
  "message": "Successfully unassigned 2 device(s) from customer",
  "customerId": "cust_abc123",
  "unassignedDevices": ["SN-001", "SN-002"],
  "skipped": [],
  "devicesRemaining": []
}

{
  "error": "Customer not found for this organization"
}

curl -X POST https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerEmail": "john.doe@example.com",
    "deviceIdentifiers": ["SN-001", "SN-002"]
  }'

const response = await fetch(
  'https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner',
  {
    method: 'POST',
    headers: {
      'x-api-key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      customerEmail: 'john.doe@example.com',
      deviceIdentifiers: ['SN-001', 'SN-002']
    })
  }
);

const result = await response.json();

import requests

response = requests.post(
    'https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner',
    headers={
        'x-api-key': 'your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'customerEmail': 'john.doe@example.com',
        'deviceIdentifiers': ['SN-001', 'SN-002']
    }
)

result = response.json()

{
  "success": true,
  "message": "Successfully unassigned 1 device(s) from customer",
  "customerId": "cust_abc123",
  "unassignedDevices": ["SN-001"],
  "skipped": ["SN-002"],
  "devicesRemaining": ["SN-003"]
}

{
  "success": true,
  "message": "Successfully unassigned 2 device(s) from customer",
  "customerId": "cust_abc123",
  "unassignedDevices": ["SN-001", "SN-002"],
  "skipped": [],
  "devicesRemaining": []
}

{
  "error": "Customer not found for this organization"
}

{
  "error": "Invalid input: customerEmail and deviceIdentifiers are required"
}

Status Codes

Code	Description
200	Devices successfully unassigned from customer
400	Invalid request (missing required fields or empty array)
401	Invalid or missing API key
404	Customer not found in your organization
500	Internal server error

Implementation Notes

Non-destructive: Customer and device records persist; only the assignments are removed
Partial success: The response details which devices were unassigned vs. skipped, so you can handle each case
Skipped devices: Devices not currently assigned to the customer are returned in the skipped array
Remaining devices: The devicesRemaining array shows the full list of devices still assigned after the operation

Common Use Cases

Bulk device returns: Unassign all returned devices from a customer in one call
Account decommissioning: Remove all device assignments when closing a customer account
Fleet reassignment: Unassign devices from one owner before reassigning to another

Bulk Transfer Pattern: Unassign devices from old owner with this endpoint → Assign to new owner with Assign Devices to Owner.

curl -X POST https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerEmail": "john.doe@example.com",
    "deviceIdentifiers": ["SN-001", "SN-002"]
  }'

const response = await fetch(
  'https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner',
  {
    method: 'POST',
    headers: {
      'x-api-key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      customerEmail: 'john.doe@example.com',
      deviceIdentifiers: ['SN-001', 'SN-002']
    })
  }
);

const result = await response.json();

import requests

response = requests.post(
    'https://admin.telemetron.ai/api/ext-v1/deviceAssignment/unassignDevicesFromOwner',
    headers={
        'x-api-key': 'your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'customerEmail': 'john.doe@example.com',
        'deviceIdentifiers': ['SN-001', 'SN-002']
    }
)

result = response.json()

{
  "success": true,
  "message": "Successfully unassigned 1 device(s) from customer",
  "customerId": "cust_abc123",
  "unassignedDevices": ["SN-001"],
  "skipped": ["SN-002"],
  "devicesRemaining": ["SN-003"]
}

{
  "success": true,
  "message": "Successfully unassigned 2 device(s) from customer",
  "customerId": "cust_abc123",
  "unassignedDevices": ["SN-001", "SN-002"],
  "skipped": [],
  "devicesRemaining": []
}

{
  "error": "Customer not found for this organization"
}

{
  "error": "Invalid input: customerEmail and deviceIdentifiers are required"
}

API Reference

Customer Management

Device Management

Device Assignment

Ticket Management

Unassign Devices from Owner

Overview

Authentication

Request Body

Response

Examples

Bulk Unassignment

Response

Status Codes

Implementation Notes

Common Use Cases

​Overview

​Authentication

​Request Body

​Response

​Examples

​Bulk Unassignment

​Response

​Status Codes

​Implementation Notes

​Common Use Cases

Overview

Authentication

Request Body

Response

Examples

Bulk Unassignment

Response

Status Codes

Implementation Notes

Common Use Cases