# Monitoring - X-Radius API > Base URL: https://x-radius.com/api/v1 > Auth: Authorization: Bearer xrt_... (a manager API token) > Envelope: {"data": ...}; lists add {"meta":{page,page_size,total,has_next}} > Errors: {"error":{"code","message","request_id"}} - branch on code, never on message > Timestamps: yyyy-MM-dd HH:mm:ss, UTC > Money: a bare JSON number in major units, with an ISO-4217 currency code beside it > Idempotency: redeem and activate endpoints take a client-supplied request_id (UUID) > > This page: https://x-radius.com/docs/api/monitoring > Every group: https://x-radius.com/llms.txt 45 endpoints in 1 resource groups. 0 carry a hand-written reference entry with examples; the remaining 45 are generated from the running router and carry method, path, authentication, permission and rate-limit bucket, but no request or response example. ### View monitoring `GET /api/v1/admin/monitoring/alerts` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Acknowledge alerts `POST /api/v1/admin/monitoring/alerts/bulk-delete` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_ack` (Acknowledge alerts) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Acknowledge alerts `POST /api/v1/admin/monitoring/alerts/clear-all` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_ack` (Acknowledge alerts) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/alerts/unacked-count` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Acknowledge alerts `POST /api/v1/admin/monitoring/alerts/{id}/ack` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_ack` (Acknowledge alerts) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/alerts/{id}/deliveries` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/devices` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `POST /api/v1/admin/monitoring/devices` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `POST /api/v1/admin/monitoring/devices/bulk-delete` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `DELETE /api/v1/admin/monitoring/devices/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `PUT /api/v1/admin/monitoring/devices/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/devices/{kind}/{ref}` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `DELETE /api/v1/admin/monitoring/devices/{kind}/{ref}/geo` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `PUT /api/v1/admin/monitoring/devices/{kind}/{ref}/geo` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `PUT /api/v1/admin/monitoring/devices/{kind}/{ref}/icon` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View network map `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/impact` - Authentication: manager session (JWT) or API token - Permission: `prm_map_view` (View network map) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/live-traffic` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read - Rate limit bucket: `t_probe` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/live-traffic/stream` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read - Rate limit bucket: `t_probe` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/notify` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `PUT /api/v1/admin/monitoring/devices/{kind}/{ref}/notify` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/owners` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `PUT /api/v1/admin/monitoring/devices/{kind}/{ref}/owners` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `POST /api/v1/admin/monitoring/devices/{kind}/{ref}/ping` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_probe` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/ping/stream` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_probe` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View network map `POST /api/v1/admin/monitoring/devices/{kind}/{ref}/share` - Authentication: manager session (JWT) or API token - Permission: `prm_map_view` (View network map) - Risk: read - Rate limit bucket: `t_egress` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/snmp-interfaces` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_probe` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/stability` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View network map `GET /api/v1/admin/monitoring/devices/{kind}/{ref}/users` - Authentication: manager session (JWT) or API token - Permission: `prm_map_view` (View network map) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `PUT /api/v1/admin/monitoring/devices/{kind}/{ref}/users` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View network map `GET /api/v1/admin/monitoring/geo` - Authentication: manager session (JWT) or API token - Permission: `prm_map_view` (View network map) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View network map `GET /api/v1/admin/monitoring/geo/hygiene` - Authentication: manager session (JWT) or API token - Permission: `prm_map_view` (View network map) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `POST /api/v1/admin/monitoring/geo/import` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View network map `GET /api/v1/admin/monitoring/geo/incidents` - Authentication: manager session (JWT) or API token - Permission: `prm_map_view` (View network map) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View network map `GET /api/v1/admin/monitoring/geo/links` - Authentication: manager session (JWT) or API token - Permission: `prm_map_view` (View network map) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `POST /api/v1/admin/monitoring/geo/links` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `POST /api/v1/admin/monitoring/geo/links/bulk-delete` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `DELETE /api/v1/admin/monitoring/geo/links/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `POST /api/v1/admin/monitoring/geo/links/{id}/reverse` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View network map `GET /api/v1/admin/monitoring/map` - Authentication: manager session (JWT) or API token - Permission: `prm_map_view` (View network map) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Edit network map `PUT /api/v1/admin/monitoring/map` - Authentication: manager session (JWT) or API token - Permission: `prm_map_edit` (Edit network map) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `POST /api/v1/admin/monitoring/sensors` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `POST /api/v1/admin/monitoring/sensors/bulk-delete` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `DELETE /api/v1/admin/monitoring/sensors/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Manage monitored devices & sensors `PUT /api/v1/admin/monitoring/sensors/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_manage` (Manage monitored devices & sensors) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View monitoring `GET /api/v1/admin/monitoring/sensors/{id}/samples` - Authentication: manager session (JWT) or API token - Permission: `prm_monitoring_view` (View monitoring) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._