---
title: "Bulk update conversations"
method: POST
path: "/inboxes/{inbox_id}/batch/update"
tags: ["Inboxes"]
---

# Bulk update conversations

`POST /inboxes/{inbox_id}/batch/update`

## Request

- Base URL: `https://api.thrivedesk.com/v1`
- URL: `https://api.thrivedesk.com/v1/inboxes/{inbox_id}/batch/update`
- Auth: HTTP bearer

Bulk update conversations.

Personal access token only. The API supports a second, partner-issued token class that is not part of the public surface. This endpoint does not accept that class.

## Path parameters

- `inbox_id` string, required

## Request body

- InboxBatchUpdateBody
  - `conversations` string[], required: IDs of the conversations to update.
  - `status` 'Active' | 'Pending' | 'Processing' | 'Closed' | 'null', nullable
  - `is_spam` boolean, nullable
  - `assign_to` string, nullable: Agent ID to assign, or null to unassign.
  - `tag` string, uuid, nullable: A single tag ID to attach to every conversation.
  - `priority` 'High' | 'Medium' | 'Low' | 'null', nullable

## Response `200`

Success.

- object
  - `message` string

## Other responses

- `401`: Missing or invalid bearer token.
- `403`: Token is valid but does not include a required scope, or the user does not have access to the resource.
- `404`: Resource not found.
- `412`: No update field was provided.
- `422`: Request body failed validation.
- `429`: Rate limit exceeded. The `Retry-After` header indicates how long to wait before retrying. See [Pagination and rate limits](/get-started/pagination) for the full rate-limit policy.
- `500`: Unexpected server error.

---

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