---
title: "Apply one action to many conversations"
method: POST
path: "/conversations/bulk"
tags: ["Conversations"]
---

# Apply one action to many conversations

`POST /conversations/bulk`

## Request

- Base URL: `https://muro.chat/api/v1`
- URL: `https://muro.chat/api/v1/conversations/bulk`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `ids` string[], required
  - `action` 'close' | 'open' | 'snooze' | 'read' | 'unread' | 'assign', required
  - `assigned_user_id` string, nullable

## Response `200`

Per-id result.

- BulkResult
  - `object` 'bulk_result'
  - `action` string
  - `updated` integer
  - `not_found` integer
  - `results` object[]
    - `id` string
    - `status` 'updated' | 'not_found'

## Other responses

- `400`: Invalid body.
- `409`: Idempotency-Key reused with a different body.
- `415`: Content-Type must be application/json.

---

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