The download links are valid for 7 days. The time starts counting as soon as the links are generated:
when you access the User Menu > Download Teramind Agent screen
the
https://<instance>/tm-api...API link is calledthe invite email is sent
New Agent Download Links on the Dashboard/Email Invite
All cloud customers will now see new links in the Dashboard for downloading the Agents.
The links will look something like this:
Revealed Agent:
https://getteramind.com/cloud-acme/1723124011/revealed/win/24.29.1912/026f2405ded0a6351a8adf858e5985b270ed4ed4/teramind_agent.exe
Hidden/Silent Agent:
https://getteramind.com/cloud-acme/1723124011/hidden/win/24.29.1912/20376a8b1457fd73d456e266177c91fe6ec4621e/teramind_agent_x64_s-i(__261e84a5119d483d322c3a398d159d493fc6b803).msi
The invitation emails will contain these links too:
Automated Download Links
You can get the links for all available Agents for an instance by using this link:
https://<instance-name>.teramind.co/tm-api/download/links?fullPaths=true
The <instance-name> is your instance name. For example:
https://acme.teramind.co/tm-api/download/links?fullPaths=true
Here’s an API call example in Postman (note that you will need to use an access token with the API):
You can also enter the above URL in the browser while signed in as an admin to get the list of Agent download links.
Using the Curl Command
You can use the API call with curl.
The following example returns a list of all Agent download links and then parses with jq for for legibility:
Command Input:
$ curl -s 'https://<instance>.teramind.co/tm-api/download/links?fullPaths=true' -H 'x-access-token: <token>' | jq
Replace the <instance> with your instance name and <token> with your access token. For example:
$ curl -s 'https://acme.teramind.co/tm-api/download/links?fullPaths=true' -H 'x-access-token: 61e408b1ce173ad3bebc9db3c7604da389a98598' | jq
Command Output:
{
"win": [
{
"name": "Windows 8+ 64-BIT MSI (REVEALED)",
"type": "revealed",
"path": "https://getteramind.com/cloud-acme/1723124654/revealed/win/24.27.1875/37b759a8946fa668149235801a276b4b5d685e7c/teramind_agent.exe"
},
{
"name": "Windows 8+ 64-BIT MSI (HIDDEN)",
"type": "stealth",
"path": "https://getteramind.com/cloud-acme/1723124654/hidden/win/24.27.1875/98c3c811058c862316a6733d8bb9504dccdc501a/teramind_agent_x64_s-i(__55ae21f06d1c1a68191155079de240d5560e36ee).msi"
}
],
"mac": [
{
"name": "Mac OS / OSX 10.13+ (REVEALED)",
"type": "revealed",
"path": "https://getteramind.com/cloud-acme/1723124654/revealed/mac/latest/dfd954b035b8f1ae05cf79f09da827b5bda648f9/tmagent-i(__55ae21f06d1c1a68191155079de240d5560e36ee).pkg"
},
{
"name": "Mac OS / OSX 10.13+ (HIDDEN)",
"type": "stealth",
"path": "https://getteramind.com/cloud-acme/1723124654/hidden/mac/latest/898fa965739dc894512f220fc6f675a2f539622c/tmagent-i(__55ae21f06d1c1a68191155079de240d5560e36ee).pkg"
}
],
"scripts": {
"win": [
{
"name": "Windows 8+ 64-BIT MSI (HIDDEN)",
"command": "msiexec /i https://getteramind.com/cloud-acme/1723124654/hidden/win/24.27.1875/98c3c811058c862316a6733d8bb9504dccdc501a/teramind_agent_x64_s-i(__55ae21f06d1c1a68191155079de240d5560e36ee).msi TMROUTER=acme.teramind.co /q /n"
}
],
"mac": {
"install": "curl -k 'https://acme.teramind.co/install-mac?t=c056154f' | sudo bash -",
"uninstall": "curl -k 'https://acme.teramind.co/uninstall-mac' | sudo bash -"
}
}
}
You can also use jq to capture a specific link, in this case the Windows Hidden/Stealth Agent link:
Command Input:
$ curl -s 'https://<instnce>.teramind.co/tm-api/download/links?fullPaths=true' -H 'x-access-token: <token>' | jq -r '.win[] | select(.type == "stealth") | .path'
Replace the <instance> with your instance name and <token> with your access token. For example:
$ curl -s 'https://acme.teramind.co/tm-api/download/links?fullPaths=true' -H 'x-access-token: 61e408b1ce173ad3bebc9db3c7604da389a98598' | jq -r '.win[] | select(.type == "stealth") | .path'
Command Output:
https://getteramind.com/cloud-acme/1723124654/hidden/win/24.27.1875/98c3c811058c862316a6733d8bb9504dccdc501a/teramind_agent_x64_s-i(__55ae21f06d1c1a68191155079de240d5560e36ee).msi
Using the PowerShell
Command Input:
PS Invoke-RestMethod -Uri 'https://<instance>.teramind.co/tm-api/download/links?fullPaths=true' -Headers @{ "x-access-token" = "<token>" }Replace the <instance> with your instance name and <token> with your access token. For example:
PS Invoke-RestMethod -Uri 'https://acme.teramind.co/tm-api/download/links?fullPaths=true' -Headers @{ "x-access-token" = "61e408b1ce173ad3bebc9db3c7604da389a98598" }
Command Output:
win
---
{@{name=Windows 8+ 64-BIT MSI (REVEALED); type=revealed; path=https://getteramind.com/cloud-acme/1723124654/revealed/win/24.27.1875/37b759a8946fa668149235801a276b4b5d685e7c/teramind_agent.exe}, @{name=Windows 8+
...
Here's an example to get the link for the Windows Hidden/Stealth Agent only:
Command Input:
(Invoke-RestMethod -Uri 'https://<instance>.teramind.co/tm-api/download/links?fullPaths=true' -Headers @{ "x-access-token" = "<token>" }).win | Where-Object { $_.type -eq "stealth" } | Select-Object -ExpandProperty pathReplace the <instance> with your instance name and <token> with your access token. For example:
(Invoke-RestMethod -Uri 'https://acme.teramind.co/tm-api/download/links?fullPaths=true' -Headers @{ "x-access-token" = "61e408b1ce173ad3bebc9db3c7604da389a98598" }).win | Where-Object { $_.type -eq "stealth" } | Select-Object -ExpandProperty path
Command Output:
https://getteramind.com/cloud-acme/1723124654/hidden/win/24.27.1875/98c3c811058c862316a6733d8bb9504dccdc501a/teramind_agent_x64_s-i(__55ae21f06d1c1a68191155079de240d5560e36ee).msi