autotask_delete_service_call_ticket

Instructions

Implementation Reference

• src/handlers/tool.definitions.ts:2785-2807 (schema)

  Schema definition for 'autotask_delete_service_call_ticket' tool, including its input schema (requires serviceCallTicketId) and destructive annotations.

    name: 'autotask_delete_service_call_ticket',
    description:
      '⚠ DESTRUCTIVE — IRREVERSIBLE. Permanently removes a ticket ' +
      'association from a service call. This action cannot be undone. ' +
      'Confirm with the user before invoking.',
    annotations: {
      title: 'Delete service call ticket association (irreversible)',
      readOnlyHint: false,
      destructiveHint: true,
      idempotentHint: false,
      openWorldHint: true,
    },
    inputSchema: {
      type: 'object',
      properties: {
        serviceCallTicketId: {
          type: 'number',
          description: 'The service call ticket record ID to delete'
        }
      },
      required: ['serviceCallTicketId']
    }
  },

• src/handlers/tool.handler.ts:903-906 (handler)

  Handler in the dispatch table that calls s.deleteServiceCallTicket(a.serviceCallTicketId) when the tool is invoked.

  ['autotask_delete_service_call_ticket', async (a) => {
    await s.deleteServiceCallTicket(a.serviceCallTicketId);
    return { result: a.serviceCallTicketId, message: `Successfully removed ticket from service call` };
  }],

• src/services/autotask.service.ts:2313-2323 (helper)

  Service-level method deleteServiceCallTicket(id) that calls http.delete('ServiceCallTickets', id) to perform the actual API call.

  async deleteServiceCallTicket(id: number): Promise<void> {
    const http = await this.ensureClient();
    try {
      this.logger.debug(`Deleting service call ticket ${id}`);
      await http.delete('ServiceCallTickets', id);
      this.logger.info(`Service call ticket ${id} deleted`);
    } catch (error) {
      this.logger.error(`Failed to delete service call ticket ${id}:`, error);
      throw error;
    }
  }

• src/handlers/tool.definitions.ts:3078-3081 (registration)

  Tool is registered in the 'service_calls' category within 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']
  }

• src/types/autotask.ts:446-451 (schema)

  Type definition for AutotaskServiceCallTicket entity (id, serviceCallID, ticketID).

  export interface AutotaskServiceCallTicket {
    id?: number;
    serviceCallID?: number;
    ticketID?: number;
    [key: string]: any;
  }