Triage

Update the triage profile

PATCH https://getinboxtriage.com/api/triage-profile

Deep-merges a patch onto the profile. VIP entries are lowercased and deduplicated.

Headers

Name	Type	Required	Description
`Authorization`	string	Required	Bearer followed by your API key.
`Content-Type`	string	Required	application/json

Request body

Name	Type	Required	Description
`defaults`	object	Optional	Merged onto the account defaults.
`byInboxId`	object	Optional	Per-inbox overrides keyed by inbox id. null for an inbox removes its override.
`setupCompletedAt`	string	Optional	ISO time the person finished first setup.
`setupVersion`	number	Optional	Version of the setup interview completed.

Response

200 OK.

Name	Type	Description
`profile.version`	number	Schema version of the profile.
`profile.defaults`	object	Account defaults: cadence, junkCategories, defaultActions, vip (people and domains), quietHours.
`profile.defaults.staleDraftDays`	number	Days before an unsent draft gets a reminder (0-30, default 3, 0 is off).
`profile.defaults.attentionDays`	number	Unread mail older than this many days no longer counts as needing attention, except VIP mail and mail from a person (0-90, default 7, 0 is off).
`profile.defaults.cleanup.auto`	boolean	When true, run_cleanup archives duplicate notifications and old calendar replies instead of only listing them. Default false.
`profile.defaults.cleanup.newsletterDays`	number	Unread newsletters older than this many days are archived by run_cleanup (0-90, default 14, 0 is off).
`profile.defaults.notes`	string	Standing instructions for the agent, up to 2000 characters; longer notes are cut on save.
`profile.defaults.screening.blocklist`	string[]	Sender domains (or full addresses for public mail domains) learned from spam reports. Mail from them counts as a strong spam signal.
`profile.defaults.screening.knownGood`	string[]	Addresses learned from mail dragged back out of Spam. Never checked for junk.
`profile.byInboxId`	object	Per-inbox overrides keyed by inbox id.
`profile.setupCompletedAt`	string \| null	When the person finished first setup.
`setupCompleted`	boolean	true once setup is stamped or an inbox is connected and synced.

Errors

Status	Error	Meaning
400	`invalid_request`	The patch is not valid. error_description says what was wrong.

Any route can also return 401 for a bad key, 402 when the trial ended or payment failed, and 429 when you send too many requests. See Errors.

Request

curl -X PATCH "https://getinboxtriage.com/api/triage-profile" \
  -H "Authorization: Bearer $INBOX_TRIAGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"defaults":{"vip":{"people":["boss@example.com"]}}}'

const res = await fetch("https://getinboxtriage.com/api/triage-profile", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.INBOX_TRIAGE_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "defaults": {
      "vip": {
        "people": [
          "boss@example.com"
        ]
      }
    }
  }),
});
const data = await res.json();

import os
import requests

res = requests.patch(
    "https://getinboxtriage.com/api/triage-profile",
    headers={"Authorization": f"Bearer {os.environ['INBOX_TRIAGE_KEY']}"},
    json={
        "defaults": {
            "vip": {
                "people": [
                    "boss@example.com",
                ],
            },
        },
    },
)
print(res.json())

Response200

{
  "profile": {
    "version": 1,
    "updatedAt": "2026-09-10T12:00:00.000Z",
    "defaults": {
      "cadence": {
        "kind": "once_daily",
        "localTime": "09:00"
      },
      "junkCategories": [
        "promos",
        "newsletters",
        "receipts",
        "social",
        "recruiting"
      ],
      "defaultActions": {
        "onJunk": "leave",
        "draftUnsubscribeWhen": "ask_first",
        "askFirstWhen": [
          "vip",
          "uncertain",
          "destructive",
          "spam"
        ]
      },
      "vip": {
        "people": [
          "boss@example.com"
        ],
        "domains": [
          "example.com"
        ]
      },
      "quietHours": {
        "enabled": false,
        "startLocal": "22:00",
        "endLocal": "07:00"
      }
    },
    "byInboxId": {},
    "setupCompletedAt": null,
    "setupVersion": null
  },
  "setupCompleted": false
}