> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# DrayTek VigorACS API

> Read your clients' Vigor routers in VigorACS, which are offline and their TR-069 values; reboot a device, change its settings, and manage networks, provisioning, user groups and users

An agent with this tool answers a router or "internet down" ticket from VigorACS: which devices the client has, whether VigorACS sees the router as offline, and the router's own firmware, WAN and LAN values. With the access you choose, it reboots a device or changes one setting.

> [!NOTE]
>
> Automatically enabled when you configure DrayTek VigorACS permissions in your agent workflow. No manual toggle needed.

## What It Does

* Find the client's networks from the [Organization Mapping](https://docs.neoagent.io/integrations/draytek-vigoracs/overview.md#your-clients-networks-are-mapped-automatically), then their devices
* Find a device by its serial number (its MAC address) or IP address
* Read which of a client's devices are offline
* Read a router's TR-069 values live, such as its model, firmware, uptime, WAN address and connected hosts (needs a System Administrator user)
* Reboot a device, change TR-069 values, and enable, disable or move a device
* Manage networks, provisioning profiles, user groups and users

The agent calls VigorACS through the [Vendor API](https://docs.neoagent.io/agents/tools/vendor-api.md) tool, with `draytek_vigoracs` as the vendor id. [Sandbox](https://docs.neoagent.io/agents/tools/built-in/sandbox.md) scripts can call VigorACS too, under the same permissions.

## Permission Groups

| Group | What it covers |
| - | - |
| **Devices** | Devices, the device count, offline devices; enable, disable, move and delete a device; serial numbers |
| **Device Settings (TR-069)** | Parameter names, values and attributes; change values and attributes; object instances |
| **Reboot & Factory Reset** | Reboot or factory reset a device |
| **Networks** | Networks: create, change and delete |
| **Provisioning Profiles** | Set-parameter and global profiles, and deploying a profile to a device |
| **User Groups** | User groups and the wholesale wizard |
| **Users & Access** | VigorACS users and group membership |

## Access Profiles

> [accordion] Read Only
>
> Every group Read Only.

> [accordion] Helpdesk
>
> Devices, Device Settings and Reboot & Factory Reset are Read/Write with technician approval; the rest Read Only.

> [accordion] IT Admin
>
> Every group Read/Write. Provisioning Profiles and Users & Access ask a technician.

> [accordion] Full Automation
>
> Every group Read/Write with no approval, except the [changes that always ask a technician](https://docs.neoagent.io/integrations/draytek-vigoracs/connecting-to-neo.md#changes-that-always-ask-a-technician).

## On a ticket

On a ticket, every call names one of the networks mapped to the ticket's company, and a call about one device is sent only when the device is on that network. The lists of every network, device, user and group, a device by IP address or device id, provisioning profiles and the wholesale wizard are not sent. With no ticket company (a chat, or a scheduled agent with no ticket), the agent reaches everything the VigorACS user can.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.