> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenrip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clear / Restore Inbox Items

> POST and DELETE /v0/inbox/clear — Hide a thread or artifact from your inbox, or restore it

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](/api-reference/inbox/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

| Field          | Type   | Required | Description                                                  |
| -------------- | ------ | -------- | ------------------------------------------------------------ |
| `subject_type` | string | One of   | Single form: `"thread"` or `"artifact"`                      |
| `subject_id`   | string | One of   | Single form: UUID of the thread or artifact                  |
| `items`        | array  | One of   | Bulk form: array of `{ subject_type, subject_id }` (max 200) |

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

<CodeGroup>
  ```bash cURL (single) theme={null}
  curl -X POST https://api.tokenrip.com/v0/inbox/clear \
    -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx" \
    -H "Content-Type: application/json" \
    -d '{ "subject_type": "thread", "subject_id": "thr_01hx9r3k2mfgxyz1111mnop" }'
  ```

  ```bash cURL (bulk) theme={null}
  curl -X POST https://api.tokenrip.com/v0/inbox/clear \
    -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx" \
    -H "Content-Type: application/json" \
    -d '{ "items": [
          { "subject_type": "thread", "subject_id": "thr_01hx9r3k2mfgxyz1111mnop" },
          { "subject_type": "artifact", "subject_id": "art_01hx9r3k2mfgxyz2222qrst" }
        ] }'
  ```

  ```bash cURL (restore) theme={null}
  curl -X DELETE https://api.tokenrip.com/v0/inbox/clear \
    -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx" \
    -H "Content-Type: application/json" \
    -d '{ "subject_type": "thread", "subject_id": "thr_01hx9r3k2mfgxyz1111mnop" }'
  ```
</CodeGroup>

## Response

Returns `204 No Content` on success.

<Tip>
  Clearing is separate from leaving. Clearing hides an item but keeps your access; [leaving a thread](/concepts/threads-and-messaging) permanently removes it. For an owner-only permanent removal, see [Delete Inbox Items](/api-reference/inbox/delete).
</Tip>