COSS
Tracking

Update a category's tracking rule

PATCH
/v1/tracking_settings/categories/{category}

Sets the rule for emails sent with this category, which wins over the environment default, e.g. to track marketing but never password-reset. Fields left out keep their value; a new rule is created with them off. 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"

Request Body

application/json
  1. body

Fields left out keep their current value; a new rule starts with both off. A send's own tracking option still wins over the rule.

opens?boolean

Track opens.

clicks?boolean

Track clicks.

Response Body

The category's rule.

application/json
  1. response

An environment's tracking default (category: null) or the rule for one category. Emails are fixed to the settings that applied when they were sent.

object*"tracking_rule"
Value in"tracking_rule"
id*string
category*|

The category the rule applies to; null for the environment default.

opens*boolean

Whether opens are tracked.

clicks*boolean

Whether clicks are tracked.

created_at*string
Formatdate-time
updated_at*string
Formatdate-time
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.updateCategory("password-reset", {  opens: false,  clicks: false,});
{  "object": "tracking_rule",  "id": "etr_01k7c8m4q2f3e9v6t5r1n0p8yz",  "category": "password-reset",  "opens": false,  "clicks": false,  "created_at": "2026-01-16T10:00:00.000Z",  "updated_at": "2026-01-16T10:00:00.000Z"}

Retrieve tracking settings GET

The environment's open and click tracking default and its category rules. For each of `opens` and `clicks`, a send's own `tracking` wins, then the rule for its `category`, then the default, then off. 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.

Update the tracking default PATCH

Sets the environment default, which applies to emails without a rule for their category. Fields left out keep their value; if there is no default yet, it is created with them off. 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.