Connect Devices

File Transfers take place between connected Devices. Connect your Devices, verify their connection status, and update the Agent when needed.

Typical onboarding flow:

text

Download Installer → Install & Register Agent → Device Appears in List → Verify Connection Status

Download the Installer

POST /api/device/install — Download the Agent installer

Download the Agent installer for the target operating system. Once the installed Agent connects to the server, the Device will appear in the Device list.

List Devices

GET /api/device — Retrieve all Devices

bash

curl "https://exacoola.innorix.com/api/device?page=1&size=20" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>"

Query parameters:

Parameter	Type	Description
`page`	integer	Page number
`size`	integer	Number of results per page
`deviceGroupId`	string	Device Group ID
`searchKeyword`	string	Search keyword
`sort`	string	Sort order (for example, `field:asc`)

Response:

json

{
  "status_code": 200,
  "message": "success",
  "data": {
    "items": [
      { "deviceId": "dev_a1", "name": "seoul-node-01", "os": "linux", "status": "online" },
      { "deviceId": "dev_b2", "name": "hanoi-node-02", "os": "windows", "status": "offline" }
    ],
    "total": 2
  }
}

Check Connection Status & Device Details

Purpose	Method · Endpoint
Check connection status	`GET /api/device/connectivity/{deviceId}`
Get Device details	`GET /api/device/{device_id}/detail`
Update Device information	`PATCH /api/device/{device_id}`
Update Agent	`PATCH /api/device/updateAgent/{deviceId}`

File Management (Explorer)

Manage files and folders on a Device remotely. uuid is an identifier used to group the same Explorer session.

Purpose	Method · Endpoint
Create folder	`POST /api/explorer/createFolder/{deviceId}`
Rename	`POST /api/explorer/renameFile/{deviceId}`
Copy	`POST /api/explorer/copyFile/{deviceId}`
Delete	`POST /api/explorer/removeFile/{deviceId}`
Move (Cut)	`POST /api/explorer/cutFile/{deviceId}`
Cancel browsing	`POST /api/explorer/cancelSearch/{deviceId}`

Create Folder — POST /api/explorer/createFolder/{deviceId}

bash

curl -X POST https://exacoola.innorix.com/api/explorer/createFolder/dev_a1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "path": "/data/export/new-folder", "uuid": "" }'

Rename — POST /api/explorer/renameFile/{deviceId}

bash

curl -X POST https://exacoola.innorix.com/api/explorer/renameFile/dev_a1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "report_final.csv", "path": "/data/export/report.csv", "uuid": "" }'

Copy — POST /api/explorer/copyFile/{deviceId}

bash

curl -X POST https://exacoola.innorix.com/api/explorer/copyFile/dev_a1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "path": "/data/backup", "overwrite": false, "uuid": "", "listFiles": ["/data/export/report.csv"] }'

Delete — POST /api/explorer/removeFile/{deviceId}

bash

curl -X POST https://exacoola.innorix.com/api/explorer/removeFile/dev_a1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "listFiles": ["/data/export/old.csv"], "uuid": "" }'