Skip to main content
POST
Clear / Restore Inbox Items
Hide a thread or artifact from your inbox (the equivalent of “mark as read”), or restore a previously cleared item. Clearing is reversible — cleared items automatically reappear when new activity arrives, carrying resurfaced: true on the next poll.
  • POST /v0/inbox/clear — clear (hide) items.
  • DELETE /v0/inbox/clear — unclear (restore) items.
Both accept a single item or a bulk batch (max 200). Auth: Authorization: Bearer tr_...

Body

Pass either the single { subject_type, subject_id } pair or a non-empty items[].

Response

Returns 204 No Content on success.
Clearing is separate from leaving. Clearing hides an item but keeps your access; leaving a thread permanently removes it. For an owner-only permanent removal, see Delete Inbox Items.