Manage devices
Use this section to add/update/delete new sites(devices).
Introduction
Data related to devices/sites is owned and managed by the device-service. The terms site and devices can be used interchangeably. A device can either represent a single device or a site depending on the use case. However hereafter only the term device will be used.
Querying devices
find all devices by companyId
GET
https://talos-app.io/api/device-service/devices/search/findByCompanyId
Use this endpoint to find all devices by their company ID.
Query Parameters
companyId
string
The company Id of your evalink talos account. Found at: https://talos-app.io/en/company-admin/integrations/api-tokens.
Headers
Authorization
string
Use 'Bearer' followed by your API Token.
find the device by groupId
GET
https://talos-app.io/api/device-service/devices/search/findByDeviceGroupId?:deviceGroupId
Use this endpoint to find the device via the device group ID.
Query Parameters
deviceGroupId
string
The relevant device group ID.
Headers
Authorization
string
Use 'Bearer' followed by your API Token.
list a specific device
GET
https://talos-app.io/api/device-service/devices/:id
Use this endpoint to retrieve the data of a single specific device.
Path Parameters
id
string
The required device ID.
Headers
Authorization
string
Use 'Bearer' followed by your API Token.
Create/Update/Delete Devices
create a device
POST
https://talos-app.io/api/device-service/devices
Use this endpoint to create a new site (device).
Headers
Authorization
string
Use 'Bearer' followed by your API-Token.
Request Body
customerCountry
string
The country of the customer.
customerEmail
string
The email of the customer.
customerPhone
string
The phone number of the customer.
customerStreet
string
The street of the customer.
customerCity
string
The city of the customer.
customerZip
string
The zip code of the customer.
customerFirstName
string
The First Name of the customer.
customerLastName
string
The Last Name of the customer.
customerCompany
string
The customer's company name.
companyId
string
The Company ID, as it is displayed on the evalink talos Web Interface.
evalinkDeviceId
string
The evalink device ID, and it needs to be unique.
Example:
update a device
PATCH
https://talos-app.io/api/device-service/devices/:id
Use this endpoint to update a specific device.
Path Parameters
id
string
The required device ID.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
delete a device
DELETE
https://talos-app.io/api/device-servicse/devices/:id
Use this endpoint to permanently delete a single device.
Path Parameters
id
string
The required device ID.
Headers
Authorization
string
Use 'Bearer' followed by your API-Token.
Site activation/deactivation
activate a device
POST
https://talos-app.io/api/device-service/devices/{id}/activate
Use this endpoint to activate a device.
Path Parameters
id
string
The Id of the device that you want to activate or deactivate.
Query Parameters
subject
string
The subject of the new device.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
deactivate a device
POST
https://talos-app.io/api/device-service/devices/{id}/deactivate
Use this endpoint to deactivate a device.
Path Parameters
id
string
The ID of the device that we want to deactivate.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
Site sharing
get share links
GET
https://talos-app.io/api/device-service/devices/:deviceId/shareLinks
Use this endpoint to list the shared links.
Path Parameters
id
string
The ID of the device you want to share.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
create a shared link
POST
https://talos-app.io/api/device-service/devices/:deviceId/shareLinks
It creates a new share link.
Path Parameters
deviceId
string
The ID of the device you want to create a shared link for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
under construction
Example:
Test mode
activate specific test mode
POST
https://talos-app.io/device-service/devices/:deviceId/test-mode
Use this endpoint to activate specific test modes automatically.
Path Parameters
deviceId
string
The ID of the device you want to activate a test mode for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
Request Body
testModeUntil
string
Ending moment of the test mode.
testModeFrom
string
Starting moment of the test mode.
testMode
string
testMode = true.
matchers
array
Find the example below.
Zones/users and partitions
get zones/users
GET
https://talos-app.io/api/device-service/devices/:id/zones
Use this endpoint to get the zone and users linked to a device.
Path Parameters
deviceId
string
The ID of the device you want to the zone/users for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
write zones/users
POST
https://talos-app.io/api/device-service/devices/:id/zones
Use this endpoint to write the zones and users of a device.
Path Parameters
deviceId
string
The ID of the device you want to write zones and users for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
Request Body
zones
array
The collection of zone IDs.
update zones/users
PATCH
https://talos-app.io/api/device-service/devices/:id/zones
Use this endpoint to update the zones and users associated with a device.
Path Parameters
deviceId
string
The ID of the device you want to update the zones and users for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
Request Body
zones
array
The collection of zone IDs.
get partitions
GET
https://talos-app.io/api/device-service/devices/:id/partitions
Use this endpoint to get the partition of a specific device.
Path Parameters
deviceId
string
The ID of the device you want to get the partition for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
write partitions
POST
https://talos-app.io/api/device-service/devices/:id/partitions
Use this endpoint to write the partitions of a device.
Path Parameters
deviceId
string
The ID of the device you want to write the partition for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
Request Body
partitions
array
The ID of the partition.
update partitions
PATCH
https://talos-app.io/api/device-service/devices/:id/partitions
Use this endpoint to update the partitions of a device.
Path Parameters
deviceId
string
The ID of the device you want to update the partition for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
Request Body
partitions
array
The ID of the partition you want to update.
Tags
list tags
GET
https://talos-app.io/api/device-service/devices/:deviceId/tag
Use this endpoint to list the tags associated with a device.
Path Parameters
deviceId
string
The ID of the device you want to get the tags for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
add tag
POST
https://talos-app.io/api/device-service/devices/:deviceId/tag
Use this endpoint to add a tag to your device.
Path Parameters
deviceId
string
The ID of the device you want to add tags to.
Headers
Authentication
string
Use 'Bearer' followed by your API token.
Request Body
tagName
string
The name of the tag you want to add content to.
tagId
string
The ID of the tag you want to add content to.
remove tag
POST
https://talos-app.io/api/device-service/devices/:deviceId/untag
Use this endpoint to remove the tag from your device.
Path Parameters
deviceId
string
The ID of the device you want to remove a tag for.
Headers
Authorization
string
Use 'Bearer' followed by your API token.
Request Body
tagName
string
The name of the tag you want to remove.
tagId
string
The ID of the tag you want to remove.
Last updated