---
title: "Set a chat's status"
method: PUT
path: "/api/v1/chats/{chat_id}/status"
tags: ["chats"]
---

# Set a chat's status

`PUT /api/v1/chats/{chat_id}/status`

## Request

- Base URL: `https://api.izap.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.izap.ai/api/v1/chats/{chat_id}/status`
- Auth: HTTP bearer

Sets the conversation's status — the value the inbox filters on. The status is held against the business/customer pair, so it survives a conversation being closed and reopened.

## Path parameters

- `chat_id` string, uuid, required

## Request body

- ChatStatusIn: The conversation's CRM status, as shown by the inbox status filter.
  - `status` 'open' | 'pending' | 'resolved' | 'archived' | 'blocked', required: New status for the conversation.

## Response `200`

Successful Response

- ChatStatusOut
  - `chat_id` string, uuid, required
  - `business_id` string, uuid, required
  - `status` 'open' | 'pending' | 'resolved' | 'archived' | 'blocked', required

## Other responses

- `401`: Missing or invalid credentials.
- `403`: The credential is valid but not authorized for this action.
- `404`: The resource, or the business named in the request, does not exist.
- `422`: Validation Error
- `default`: Unexpected error.

---

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