autotask_delete_service_call
Destructive
Permanently delete a service call and its associated data from Autotask. This irreversible action removes the record entirely.
Instructions
⚠ DESTRUCTIVE — IRREVERSIBLE. Permanently deletes a service call and all associated data. This action cannot be undone. Confirm with the user before invoking.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| serviceCallId | Yes | The service call ID to delete |
Implementation Reference
- src/handlers/tool.handler.ts:889-892 (handler)The dispatch entry in the handler that delegates to autotaskService.deleteServiceCall() and returns the result.
['autotask_delete_service_call', async (a) => { await s.deleteServiceCall(a.serviceCallId); return { result: a.serviceCallId, message: `Successfully deleted service call ${a.serviceCallId}` }; }], - Schema definition for autotask_delete_service_call with input schema requiring serviceCallId, marked as destructive.
name: 'autotask_delete_service_call', description: '⚠ DESTRUCTIVE — IRREVERSIBLE. Permanently deletes a service call ' + 'and all associated data. This action cannot be undone. ' + 'Confirm with the user before invoking.', annotations: { title: 'Delete service call (irreversible)', readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true, }, inputSchema: { type: 'object', properties: { serviceCallId: { type: 'number', description: 'The service call ID to delete' } }, required: ['serviceCallId'] } - src/handlers/tool.definitions.ts:3078-3080 (registration)The tool is registered under the 'service_calls' category in TOOL_CATEGORIES.
service_calls: { description: 'Service call dispatching, ticket linking, and resource assignments', tools: ['autotask_search_service_calls', 'autotask_get_service_call', 'autotask_create_service_call', 'autotask_update_service_call', 'autotask_delete_service_call', 'autotask_search_service_call_tickets', 'autotask_create_service_call_ticket', 'autotask_delete_service_call_ticket', 'autotask_search_service_call_ticket_resources', 'autotask_create_service_call_ticket_resource', 'autotask_delete_service_call_ticket_resource'] - The service layer method that calls the HTTP client to DELETE /ServiceCalls/{id}.
async deleteServiceCall(id: number): Promise<void> { const http = await this.ensureClient(); try { this.logger.debug(`Deleting service call ${id}`); await http.delete('ServiceCalls', id); this.logger.info(`Service call ${id} deleted`); } catch (error) { this.logger.error(`Failed to delete service call ${id}:`, error); throw error; }