curl --request PATCH \
--url http://localhost:3333/v1/people/{id}/unlink-device \
--header 'X-API-Key: <api-key>'{
"id": "mem_abc123def456",
"organizationId": "org_abc123def456",
"userId": "usr_abc123def456",
"role": "member",
"createdAt": "2024-01-01T00:00:00Z",
"department": "it",
"isActive": true,
"fleetDmLabelId": 123,
"user": {
"id": "usr_abc123def456",
"name": "John Doe",
"email": "[email protected]",
"emailVerified": true,
"image": "https://example.com/avatar.jpg",
"createdAt": "2024-01-01T00:00:00Z",
"updatedAt": "2024-01-15T00:00:00Z",
"lastLogin": "2024-01-15T12:00:00Z"
}
}Resets the fleetDmLabelId for a member, effectively unlinking their device from FleetDM. This will disconnect the device from the organization. Supports both API key authentication (X-API-Key header) and session authentication (cookies + X-Organization-Id header).
curl --request PATCH \
--url http://localhost:3333/v1/people/{id}/unlink-device \
--header 'X-API-Key: <api-key>'{
"id": "mem_abc123def456",
"organizationId": "org_abc123def456",
"userId": "usr_abc123def456",
"role": "member",
"createdAt": "2024-01-01T00:00:00Z",
"department": "it",
"isActive": true,
"fleetDmLabelId": 123,
"user": {
"id": "usr_abc123def456",
"name": "John Doe",
"email": "[email protected]",
"emailVerified": true,
"image": "https://example.com/avatar.jpg",
"createdAt": "2024-01-01T00:00:00Z",
"updatedAt": "2024-01-15T00:00:00Z",
"lastLogin": "2024-01-15T12:00:00Z"
}
}API key for authentication
Organization ID (required for session auth, optional for API key auth)
Member ID
"mem_abc123def456"
Member updated successfully
Member ID
"mem_abc123def456"
Organization ID this member belongs to
"org_abc123def456"
User ID associated with member
"usr_abc123def456"
Member role
"admin"
When the member was created
"2024-01-01T00:00:00Z"
Member department
none, admin, gov, hr, it, itsm, qms "it"
Whether member is active
true
FleetDM label ID for member devices
123
User information
Show child attributes
Was this page helpful?