---
title: "Mark email as read/unread (account-level)"
method: PATCH
path: "/v1/inbox/{uid}"
tags: ["Inbox"]
---

# Mark email as read/unread (account-level)

`PATCH /v1/inbox/{uid}`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/inbox/{uid}`
- Auth: HTTP bearer

Update the read status of an email. Uses the mailbox query parameter
to identify the correct email user for the IMAP operation.

## Path parameters

- `uid` string, required

## Query parameters

- `mailbox` string, required

## Request body

- MarkReadRequest
  - `is_read` boolean, required: True to mark as read, false to mark as unread

## Response `200`

Read status updated

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` MarkReadResponse
    - `message_id` string
    - `is_read` boolean

## Other responses

- `400`: Validation error
- `401`: Authentication required or token invalid
- `404`: Resource not found

---

[API](https://skmtc.dev/winnr/apis/winnr-api.md) · [All operations](https://skmtc.dev/winnr/apis/winnr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winnr/apis/winnr-api/revisions/a4f960beb1eb?raw)