Inbox

POST /public/v1/approvals/messages/batch-read-status

Update the read status of multiple messages in batch.

Request

Base URL
https://api.joinvalley.co
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/joinvalley/apis/valley-public-api/docs/public/v1/approvals/messages/batch-read-status/post.ts
A function with typed inputs. Its response is checked against the schema.

isReadboolean required

Set to true to mark messages as read, false to mark as unread.

workspaceIdstring

Scope to a specific workspace. One of workspaceId, campaignIds, or confirmAll is required.

campaignIdsstring

Comma-separated campaign IDs to scope the operation to.

confirmAllboolean

Set to true to act on all campaigns in the workspace. Requires workspaceId. Optionally narrow with campaignIds.

searchstring

Filter by prospect first or last name.

icpFitstring

Comma-separated ICP fit values to filter by (e.g. HIGH, MEDIUM).

prospectInterestLevelstring

Comma-separated interest level values to filter by.

fromstring

Filter messages created on or after this date (YYYY-MM-DD).

tostring

Filter messages created on or before this date (YYYY-MM-DD).

ownerIdstring

Admin/Owner only: scope results to a specific workspace member by their user ID.

Default Response

statusCodenumber

statusboolean

messagestring

No recorded changes to this operation across all 9 revisions of this API.