Matrix URIs
This list shows the methods and endpoints available for Matrix. Using them you can accomplish nearly any task you can imagine to control or configure Matrix.
REST sometimes is referred to as using QCRUD, where each letter stands for a different action that can be taken: Query, Create, Read, Update, Delete. The REST API is comprised of these HTTP actions:
♦GET: used to query for or read data from the server, like user IDs or dashboard results. GET is considered a “safe” method because no changes on the server are made.
♦POST: used to create new objects, like users, users, or dashboards. For a POST method, the HTTP response contains the URI path and {ID} of the newly created resource in the “Location” HTTP header. For example, when a new user is created, the “Location” HTTP header will contain: "/users/9D24469A-976E-11E4-B88F-002590365523".
♦PUT: used to update an existing object. All PUT methods must always take the full resource definition, not just fields being modified. A PUT request is considered Idempotent or “unsafe” because it can change an existing object. This is not to imply that PUT actions should not be done. Not at all. Instead, it means simply that you must ensure that the definition you send has exactly the values you want it to have before issuing the PUT.
♦DELETE: used to delete an object. A DELETE is also considered Idempotent. After an object has been deleted with the DELETE method, it cannot be restored. There is no confirmation requested like there is in the web interface. Use with care!
All time values are specified in UTC using the ISO8601 time format: "2015-10-24T04:06:16Z". The Z at the end of the format indicates that there is no time offset from UTC. UTC does not observe summer time (daylight savings time). It is also possible that UTC may be several hours different from your local time. The web UI client uses its local browser time, but all API requests use UTC. The base URI is described in .
Methods | URI |
|---|
GET DELETE | /api/alerts |
GET DELETE | /api/alerts/{alertId} |
GET | /api/backup |
GET | /api/bpfConstants |
GET | /api/counts/live/ports |
GET | /api/counts/live/ports/{id} |
GET | /api/counts/live/sysmon |
GET DELETE | /api/counts/cumulative/ports |
GET DELETE | /api/counts/cumulative/ports/{id} |
GET PUT | /api/eula |
POST | /api/factoryClean |
GET POST | /api/filters |
GET PUT DELETE | /api/filters/{filterId} |
GET | /api/firmware |
GET POST | /api/groups |
GET POST | /api/groups/remote |
GET PUT DELETE | /api/groups/{groupId} |
GET POST | /api/layouts |
GET PUT | /api/layouts/active |
GET PUT DELETE | /api/layouts/{layoutId} |
GET PUT | /api/license |
GET | /api/license/request |
GET | /api/limits |
GET | /api/logs |
GET | /api/logs/all |
GET | /api/logs/current |
GET | /api/logs/{idx} |
GET POST DELETE | /api/login |
GET | /api/longpoll/{clientId} |
GET | /api/networkInfo |
GET | /api/nimsKey |
GET | /api/permissionSet |
GET PUT | /api/power |
GET POST | /api/rules |
GET PUT DELETE | /api/rules/{ruleId} |
GET | /api/settings |
GET PUT | /api/settings/authentication |
GET PUT | /api/settings/log |
GET PUT | /api/settings/network |
GET PUT | /api/settings/general |
GET | /api/snapshot |
GET POST | /api/subscriptions |
GET PUT DELETE | /api/subscriptions/{id} |
GET PUT | /api/time |
GET POST | /api/users |
GET POST | /api/users/remote |
GET PUT DELETE | /api/users/{userId} |