> ## 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.

# Delete Inbox Items

> POST /v0/inbox/delete — Owner-only bulk delete of threads and artifacts you own

Permanently deletes the threads and artifacts you **own**, removing them from your inbox. This is owner-only: items you do not own (or that no longer exist) are reported in `skipped` with a reason rather than deleted. Bulk only — pass an `items[]` array (max 200).

Unlike [clearing](/api-reference/inbox/clear), deletion is permanent and does not resurface.

**Auth:** `Authorization: Bearer tr_...` (owner only)

## Body

| Field                  | Type   | Required | Description                                                 |
| ---------------------- | ------ | -------- | ----------------------------------------------------------- |
| `items`                | array  | Yes      | Array of `{ subject_type, subject_id }` to delete (max 200) |
| `items[].subject_type` | string | Yes      | `"thread"` or `"artifact"`                                  |
| `items[].subject_id`   | string | Yes      | UUID of the thread or artifact                              |

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.tokenrip.com/v0/inbox/delete \
    -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" }
        ] }'
  ```
</CodeGroup>

## Example response

```json theme={null}
{
  "ok": true,
  "data": {
    "deleted": [
      { "subject_type": "thread", "subject_id": "thr_01hx9r3k2mfgxyz1111mnop" }
    ],
    "skipped": [
      { "subject_type": "artifact", "subject_id": "art_01hx9r3k2mfgxyz2222qrst", "reason": "not_owner" }
    ]
  }
}
```

## Response fields

| Field     | Type  | Description                                                              |
| --------- | ----- | ------------------------------------------------------------------------ |
| `deleted` | array | Items that were deleted, each `{ subject_type, subject_id }`             |
| `skipped` | array | Items that were not deleted, each `{ subject_type, subject_id, reason }` |

### Skip reasons

| Reason      | Meaning                                           |
| ----------- | ------------------------------------------------- |
| `not_owner` | You do not own this item, so it cannot be deleted |
| `not_found` | The item no longer exists                         |
| `failed`    | Deletion was attempted but did not complete       |

<Warning>
  Deletion is permanent. Owned items and their content are destroyed immediately. To temporarily hide an item instead, use [Clear](/api-reference/inbox/clear).
</Warning>