# Tools - 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/tools > Every group: https://x-radius.com/llms.txt 48 endpoints in 1 resource groups. 0 carry a hand-written reference entry with examples; the remaining 48 are generated from the running router and carry method, path, authentication, permission and rate-limit bucket, but no request or response example. ### Manage announcements `GET /api/v1/admin/tools/announcements` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_announcements` (Manage announcements) - Risk: write _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 announcements `POST /api/v1/admin/tools/announcements` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_announcements` (Manage announcements) - Risk: write - 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 announcements `POST /api/v1/admin/tools/announcements/preview-count` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_announcements` (Manage announcements) - 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 announcements `GET /api/v1/admin/tools/announcements/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_announcements` (Manage announcements) - Risk: write _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._ ### Backup & restore `GET /api/v1/admin/tools/backup` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger _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._ ### Backup & restore `POST /api/v1/admin/tools/backup` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### Backup & restore `POST /api/v1/admin/tools/backup/bulk-delete` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger - 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._ ### Backup & restore `GET /api/v1/admin/tools/backup/jobs` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger _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._ ### Backup & restore `GET /api/v1/admin/tools/backup/jobs/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger _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._ ### Backup & restore `GET /api/v1/admin/tools/backup/schedule` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger _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._ ### Backup & restore `PUT /api/v1/admin/tools/backup/schedule` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger - 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._ ### Backup & restore `POST /api/v1/admin/tools/backup/upload` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### Backup & restore `DELETE /api/v1/admin/tools/backup/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger - 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._ ### Backup & restore `GET /api/v1/admin/tools/backup/{id}/download` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### Backup & restore `POST /api/v1/admin/tools/backup/{id}/download-ticket` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### Backup & restore `POST /api/v1/admin/tools/backup/{id}/restore` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_backup` (Backup & restore) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### Bandwidth control `GET /api/v1/admin/tools/bandwidth` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bandwidth_control` (Bandwidth control) - Risk: danger _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._ ### Bandwidth control `POST /api/v1/admin/tools/bandwidth/apply` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bandwidth_control` (Bandwidth control) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### Bandwidth control `GET /api/v1/admin/tools/bandwidth/history` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bandwidth_control` (Bandwidth control) - Risk: danger _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._ ### Bandwidth control `GET /api/v1/admin/tools/bandwidth/schedules` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bandwidth_control` (Bandwidth control) - Risk: danger _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._ ### Bandwidth control `POST /api/v1/admin/tools/bandwidth/schedules` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bandwidth_control` (Bandwidth control) - Risk: danger - 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._ ### Bandwidth control `POST /api/v1/admin/tools/bandwidth/schedules/bulk-delete` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bandwidth_control` (Bandwidth control) - Risk: danger - 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._ ### Bandwidth control `DELETE /api/v1/admin/tools/bandwidth/schedules/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bandwidth_control` (Bandwidth control) - Risk: danger - 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._ ### Bandwidth control `PATCH /api/v1/admin/tools/bandwidth/schedules/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bandwidth_control` (Bandwidth control) - Risk: danger - 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._ ### Bulk changes `POST /api/v1/admin/tools/bulk/apply` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bulk_changes` (Bulk changes) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### Bulk changes `GET /api/v1/admin/tools/bulk/jobs` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bulk_changes` (Bulk changes) - Risk: danger _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._ ### Bulk changes `GET /api/v1/admin/tools/bulk/jobs/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bulk_changes` (Bulk changes) - Risk: danger _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._ ### Bulk changes `POST /api/v1/admin/tools/bulk/preview` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_bulk_changes` (Bulk changes) - Risk: danger - 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._ ### Dashboard Manager `GET /api/v1/admin/tools/dashboards` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - Risk: write _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._ ### Dashboard Manager `POST /api/v1/admin/tools/dashboards` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - 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._ ### Dashboard Manager `POST /api/v1/admin/tools/dashboards/bulk-delete` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - 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._ ### Dashboard Manager `POST /api/v1/admin/tools/dashboards/restore-defaults` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - 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._ ### Dashboard Manager `DELETE /api/v1/admin/tools/dashboards/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - 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._ ### Dashboard Manager `GET /api/v1/admin/tools/dashboards/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - Risk: write _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._ ### Dashboard Manager `PUT /api/v1/admin/tools/dashboards/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - 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._ ### Factory reset `POST /api/v1/admin/tools/factory-reset` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_factory_reset` (Factory reset) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### Factory reset `GET /api/v1/admin/tools/factory-reset/preview` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_factory_reset` (Factory reset) - Risk: danger _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._ ### System maintenance `GET /api/v1/admin/tools/maintenance/operations` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_maintenance` (System maintenance) - Risk: danger - Rate limit bucket: `t_heavy` _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._ ### System maintenance `POST /api/v1/admin/tools/maintenance/run` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_maintenance` (System maintenance) - Risk: danger - 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._ ### System maintenance `GET /api/v1/admin/tools/maintenance/runs` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_maintenance` (System maintenance) - Risk: danger _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._ ### Dashboard Manager `GET /api/v1/admin/tools/widget-data/sources` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - Risk: write _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._ ### Dashboard Manager `GET /api/v1/admin/tools/widget-data/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_dashboard_manager` (Dashboard Manager) - Risk: write _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._ ### Widget Factory `GET /api/v1/admin/tools/widgets` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_widget_factory` (Widget Factory) - Risk: write _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._ ### Widget Factory `POST /api/v1/admin/tools/widgets` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_widget_factory` (Widget Factory) - 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._ ### Widget Factory `POST /api/v1/admin/tools/widgets/bulk-delete` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_widget_factory` (Widget Factory) - 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._ ### Widget Factory `DELETE /api/v1/admin/tools/widgets/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_widget_factory` (Widget Factory) - 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._ ### Widget Factory `GET /api/v1/admin/tools/widgets/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_widget_factory` (Widget Factory) - Risk: write _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._ ### Widget Factory `PUT /api/v1/admin/tools/widgets/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_tools_widget_factory` (Widget Factory) - 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._