COSS
Tracking

Remove a category's tracking rule

DELETE
/v1/tracking_settings/categories/{category}

Removes the rule: emails of this category follow the environment default again. Settings belong to the API key's own environment: a coss_test_… key only ever changes sandbox settings. Emails keep the settings that applied when they were sent.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.

Path Parameters

category*string

The category, as sent in category.

Match^[A-Za-z0-9_-]{1,256}$

Header Parameters

Coss-Version?"2026-10-10"

The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.

Value in"2026-10-10"

Response Body

The rule was removed.

application/json
  1. response
object*"tracking_rule"
Value in"tracking_rule"
id*string
category*string|null
deleted*true
Value intrue
import { Coss } from "coss";const coss = new Coss({  apiKey: process.env.COSS_API_KEY,  baseUrl: "https://api.coss.com",});const { data, error } = await coss.email.tracking.removeCategory("password-reset");
{  "object": "tracking_rule",  "id": "etr_01k7c8m4q2f3e9v6t5r1n0p8yz",  "category": "password-reset",  "deleted": true}

List suppressed addresses GET

The suppression list of the API key's environment, newest first. Pass the last `id` as `after` to get the next page while `has_more` is true.

Remove the tracking default DELETE

Removes the environment default: emails without a rule for their category are then not tracked unless the send asks. Settings belong to the API key's own environment: a `coss_test_…` key only ever changes sandbox settings. Emails keep the settings that applied when they were sent.