feat: delete tracker (#535)

Co-authored-by: Claude Sonnet 4.5 <[email protected]>

Author: Justintime50

CHANGELOG.md

@@ -7,6 +7,7 @@
   - `ApiKey.delete`
   - `ApiKey.enable`
   - `ApiKey.disable`
+- Adds a `Tracker.delete` function
 
 ## v8.4.0 (2025-11-24)
 

src/services/tracker_service.js

@@ -74,4 +74,22 @@ export default (easypostClient) =>
         return Promise.reject(e);
       }
     }
+
+    /**
+     * Delete a {@link Tracker tracker}.
+     * See {@link https://docs.easypost.com/docs/trackers#delete-a-tracker EasyPost API Documentation} for more information.
+     * @param {string} id - The ID of the tracker to delete.
+     * @returns {Promise<void>}
+     */
+    static async delete(id) {
+      const url = `trackers/${id}`;
+
+      try {
+        await easypostClient._delete(url);
+
+        return Promise.resolve();
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    }
   };

test/cassettes/Tracker-Service_4233073632/deletes-a-tracker_3282233340/recording.har

@@ -84,4 +84,13 @@ describe('Tracker Service', function () {
       expect(tracker).to.be.an.instanceOf(Tracker);
     });
   });
+
+  it('deletes a tracker', async function () {
+    const tracker = await client.Tracker.create({
+      tracking_code: 'EZ1000000001',
+    });
+
+    // Nothing gets returned here, simply ensure no error gets raised
+    await client.Tracker.delete(tracker.id);
+  });
 });

test/services/tracker.test.js

@@ -187,4 +187,14 @@ export declare class Tracker implements ITracker {
     trackers: Object,
     pageSize?: number,
   ): Promise<{ trackers: Tracker[]; has_more: boolean }>;
+
+  /**
+   * Delete a Tracker.
+   *
+   * @see https://docs.easypost.com/docs/trackers#delete-a-tracker
+   *
+   * @param {string} id - The id of the tracker to delete, starts with "trk_"
+   * @returns {Promise<void>}
+   */
+  static delete(id: string): Promise<void>;
 }