Valley

Inbox

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

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.

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

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

curl --request POST \
  --url 'https://api.joinvalley.co/public/v1/inbox/conversations/batch-read-status' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'
{
  "statusCode": 1,
  "status": true,
  "message": "<string>",
  "data": {
    "affected": 1
  }
}

Default Response

Authorizations

  • x-api-key string required header

    Your Valley API key.

Request Body

application/json
  • 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

application/json
  • statusCode number
  • status boolean
  • message string
  • data object
    + Show Child Attributes
    • affected number