REST APIs : Available operations and endpoints : Matrix URIs
  
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 Base structure.
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}