Skip to main content

How to obtain the Agent download links (Cloud)

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 called

  • the invite email is sent

Getting Download Links from the Dashboard

You can copy the Agent download links from the System > Download Agent screen:

Select the Stealth Agent/Standard or the Revealed Agent tab, then click the Copy icon.

Getting Download Links via Emails

You can use the Send instructions to me or the Invite users option from the Revealed Agent tab under System > Download Agent screen to get the download links:

The email will contain the links:

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 path

Replace 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
Related Articles
Did this answer your question?