---
title: "POST /public/v1/inbox/conversations/batch-read-status"
method: POST
path: "/public/v1/inbox/conversations/batch-read-status"
tags: ["Inbox"]
---

# POST /public/v1/inbox/conversations/batch-read-status

`POST /public/v1/inbox/conversations/batch-read-status`

## Request

- Base URL: `https://api.joinvalley.co`
- URL: `https://api.joinvalley.co/public/v1/inbox/conversations/batch-read-status`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/joinvalley/apis/valley-public-api/docs/public/v1/inbox/conversations/batch-read-status/post.ts> (a function with typed inputs; its response is checked against the schema)

Update the read status of multiple conversations in batch. Workspace admins and owners can scope to all campaigns in a workspace. Workspace members can only act on their own campaigns.

## Request body

- object
  - `isRead` boolean, required: Set to true to mark conversations as read, false to mark as unread.
  - `workspaceId` string: Scope to a specific workspace. One of workspaceId, campaignIds, or confirmAll is required. Admins and owners see all campaigns in the workspace; members see only their own.
  - `campaignIds` string: Comma-separated campaign IDs to scope the operation to.
  - `confirmAll` boolean: Set to true to act on all campaigns in the workspace. Requires workspaceId. Optionally narrow with campaignIds.
  - `icpFit` string: Comma-separated ICP fit values to filter by (e.g. STRONG,GOOD).
  - `prospectInterestLevel` string: Comma-separated interest level values to filter by.
  - `ownerId` string: Admin/Owner only: scope results to a specific workspace member by their user ID.

## Response `200`

Default Response

- object
  - `statusCode` number
  - `status` boolean
  - `message` string
  - `data` object
    - `affected` number

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `429`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/joinvalley/apis/valley-public-api.md) - [All operations](https://skmtc.dev/joinvalley/apis/valley-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/joinvalley/apis/valley-public-api/revisions/798c2eb1b512?raw)