Retrieves a paginated list of all devices registered to the tenant with support for filtering, sorting, and search. This endpoint provides comprehensive device information including connection status, user associations, and hardware details.
Number of items to return per page. Use with “offset” for pagination. If omitted, a default is applied. A maximum may be enforced by the server.
Number of items to skip before returning results. Use with “limit”. For page-based navigation: offset = page × limit.
Successfully retrieved devices
Paginated response containing data and pagination metadata
Array of items for the current page
Total number of items across all pages for the given filters. Use this with “limit” to compute total pages: totalPages = ceil(total / limit).
Current page index (0-based). For offset-based pagination, page = floor(offset / limit). For page[] style, this equals the N used in page[offset] = N × page[limit].
Number of items per page returned in this response. Mirrors the query “limit” or “page[limit]” parameter used for the request.
Whether there are more pages available
Whether there are previous pages available
Retrieves comprehensive information about a specific device including its configuration, connection status, associated user, hardware details, and security posture information.
The unique identifier (UUID) of the device
Example:123e4567-e89b-12d3-a456-426614174000
Successfully retrieved the device
Device information including connection status, user association, and security posture
Unique identifier for the device
Timestamp when the device was registered
Timestamp when the device information was last updated
Human-readable name for the device
Whether the device is currently active and can connect
Timestamp of the device’s last network connection
Current connection status of the device
Allowed values:OnlineOfflineDeactivated
Information about the user who owns this device
Example:{"id":"550e8400-e29b-41d4-a716-446655440000","email":"john.doe@company.com","firstName":"John","lastName":"Doe","lastConnection":"2023-01-15T14:30:00Z"}
Unique hardware identifier for the device
Security posture information and compliance status
Version of the Cipherscale client application installed on the device
Permanently removes a device from the tenant. This operation will disconnect the device from the network and revoke all associated access permissions.
The unique identifier (UUID) of the device to delete
Successfully deleted the device
Temporarily disables a device, preventing it from connecting to the network while preserving its configuration and user association. This is useful for security incidents or temporary access restrictions.
The unique identifier (UUID) of the device to deactivate
Successfully deactivated the device
Restores network access for a previously deactivated device. This operation allows the device to reconnect to the network with its previous configuration and permissions.
The unique identifier (UUID) of the device to reactivate
Successfully reactivated the device