cancel_device_maintenance
Cancel active maintenance windows to immediately re-enable alerting for monitored devices in NinjaOne.
Instructions
Cancel an active maintenance window for a device, immediately re-enabling alerting.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_id | Yes | NinjaOne device ID to remove from maintenance |
Implementation Reference
- src/tools/maintenance.ts:93-105 (handler)Handler function for cancel_device_maintenance tool. Makes a DELETE request to /device/{device_id}/maintenance endpoint to cancel the maintenance window and re-enable alerting.
async ({ device_id }) => { try { await client.delete(`/device/${device_id}/maintenance`); return toolResult( `Maintenance window cancelled for device ${device_id}. Alerting is now re-enabled.`, ); } catch (error) { return toolResult( `Error cancelling maintenance window: ${error}`, true, ); } }, - src/tools/maintenance.ts:88-91 (schema)Zod schema definition for the cancel_device_maintenance tool input. Defines device_id as a required number parameter describing the NinjaOne device ID.
{ device_id: z .number() .describe("NinjaOne device ID to remove from maintenance"), - src/tools/maintenance.ts:85-106 (registration)Registration of cancel_device_maintenance tool with MCP server. Includes tool name, description, input schema, and handler function.
server.tool( "cancel_device_maintenance", "Cancel an active maintenance window for a device, immediately re-enabling alerting.", { device_id: z .number() .describe("NinjaOne device ID to remove from maintenance"), }, async ({ device_id }) => { try { await client.delete(`/device/${device_id}/maintenance`); return toolResult( `Maintenance window cancelled for device ${device_id}. Alerting is now re-enabled.`, ); } catch (error) { return toolResult( `Error cancelling maintenance window: ${error}`, true, ); } }, );