delete_target_list
Remove a target list from Firewalla MSP firewall to manage network security rules and reduce attack surface by eliminating outdated or unnecessary access controls.
Instructions
Delete a target list
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Target list ID to delete (required) |
Implementation Reference
- src/tools/handlers/rules.ts:1755-1817 (handler)The DeleteTargetListHandler class implements the core logic for the 'delete_target_list' tool. It validates the required 'id' parameter, calls firewalla.deleteTargetList(id), handles errors and timeouts, and returns a unified response.
export class DeleteTargetListHandler extends BaseToolHandler { name = 'delete_target_list'; description = 'Delete a target list from Firewalla'; category = 'rule' as const; constructor() { super({ enableGeoEnrichment: false, enableFieldNormalization: true, additionalMeta: { data_source: 'target_lists', entity_type: 'target_list_deletion', supports_geographic_enrichment: false, supports_field_normalization: true, standardization_version: '2.0.0', }, }); } async execute( args: ToolArgs, firewalla: FirewallaClient ): Promise<ToolResponse> { try { const idValidation = ParameterValidator.validateRequiredString( args?.id, 'id' ); if (!idValidation.isValid) { return createErrorResponse( this.name, 'Parameter validation failed', ErrorType.VALIDATION_ERROR, undefined, idValidation.errors ); } const id = idValidation.sanitizedValue as string; const response = await withToolTimeout( async () => firewalla.deleteTargetList(id), this.name ); return this.createUnifiedResponse(response); } catch (error: unknown) { if (error instanceof TimeoutError) { return createTimeoutErrorResponse(this.name, error.duration, 10000); } const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred'; return createErrorResponse( this.name, `Failed to delete target list: ${errorMessage}`, ErrorType.API_ERROR, { id: args?.id } ); } } } - src/server.ts:421-433 (schema)MCP tool schema definition for 'delete_target_list' including input schema requiring 'id' string parameter.
name: 'delete_target_list', description: 'Delete a target list', inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'Target list ID to delete (required)', }, }, required: ['id'], }, }, - src/tools/registry.ts:153-153 (registration)Registration of DeleteTargetListHandler instance in the ToolRegistry during auto-registration of rule tools.
this.register(new DeleteTargetListHandler()); - src/tools/registry.ts:54-56 (registration)Import statement for DeleteTargetListHandler from rules handlers module.
DeleteTargetListHandler, GetNetworkRulesSummaryHandler, } from './handlers/rules.js';