Triage

End a triage pass

POST https://getinboxtriage.com/api/inboxes/{id}/triage/end

Releases your lease and records the pass. Safe to call when the lease already ran out.

Headers

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

Path parameters

NameTypeRequiredDescription
id string Required Inbox id from List inboxes, like inbox_lx2k9a1b.

Request body

NameTypeRequiredDescription
agentLabel string Required The same label you began with.
summary string Optional What the pass did, up to 500 characters. The person and the next agent can read it.

Response

200 OK.

NameTypeDescription
ok boolean true when the pass was recorded.
lastTriageEndedAt string When the pass ended.

Errors

StatusErrorMeaning
400 invalid_request agentLabel is missing.
404 inbox_not_found The inbox id is wrong or the inbox was removed.
409 lease_busy Another agent holds the lease. The body also has ok: false, busy: true, heldBy, and leaseExpiresAt.
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.