Inboxes

Remove an inbox

DEL https://getinboxtriage.com/api/inboxes/{id}

Disconnects an inbox and deletes its stored credential and synced mail. For Google it also revokes the grant at Google.

Mail in the mailbox itself is not touched. Only the copy Inbox Triage keeps is deleted.

Headers

Name	Type	Required	Description
`Authorization`	string	Required	Bearer followed by your API key.

Path parameters

Name	Type	Required	Description
`id`	string	Required	Inbox id from List inboxes, like inbox_lx2k9a1b.

Response

200 OK.

Name	Type	Description
`ok`	boolean	Always true.

Errors

Status	Error	Meaning
404	`inbox_not_found`	The inbox id is wrong or the inbox was removed.
409	`inbox_paused`	The person paused this inbox. They resume it on the Inboxes page.

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 DELETE "https://getinboxtriage.com/api/inboxes/inbox_lx2k9a1b" \
  -H "Authorization: Bearer $INBOX_TRIAGE_KEY"

const res = await fetch("https://getinboxtriage.com/api/inboxes/inbox_lx2k9a1b", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.INBOX_TRIAGE_KEY}`,
  },
});
const data = await res.json();

import os
import requests

res = requests.delete(
    "https://getinboxtriage.com/api/inboxes/inbox_lx2k9a1b",
    headers={"Authorization": f"Bearer {os.environ['INBOX_TRIAGE_KEY']}"},
)
print(res.json())

Response200

{
  "ok": true
}