---
title: "Update conversation statuses"
method: POST
path: "/conversations/bulk/status"
tags: ["Conversations"]
---

# Update conversation statuses

`POST /conversations/bulk/status`

## Request

- Base URL: `https://api.sequenzy.com/api/v1`
- URL: `https://api.sequenzy.com/api/v1/conversations/bulk/status`
- Auth: HTTP bearer

Opens or closes up to 100 conversations in one request. Only conversations whose status changes are updated, so retries are safe. IDs that do not exist in the company are reported in `notFoundIds` and do not fail the request.

## Request body

- object
  - `conversationIds` string[], required: Conversation IDs to update, up to 100. Whitespace is trimmed and blank or repeated IDs are ignored; at least one non-blank ID is required.
  - `status` 'open' | 'closed', required: New status for every listed conversation.

## Response `200`

Statuses updated

- object
  - `success` boolean
  - `status` 'open' | 'closed'
  - `requested` integer: Distinct conversation IDs in the request.
  - `updated` integer: Conversations whose status changed.
  - `unchanged` integer: Conversations that already had the status.
  - `notFound` integer: IDs that do not exist in the company.
  - `updatedIds` string[]: IDs whose status changed, in request order.
  - `unchangedIds` string[]: IDs that already had the status, in request order.
  - `notFoundIds` string[]: IDs that do not exist in the company, in request order.

## Other responses

- `400`: No usable conversation IDs, or more than 100 distinct IDs
- `401`: Unauthorized
- `403`: API key is missing the conversations:write scope
- `422`: Missing or unknown status, missing or non-array conversationIds, or a non-string ID

## Changes

- **2026-10-16** `db3873ca3d4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/conversations/bulk/status/post.md)

---

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