---
title: "Archive or unarchive a conversation"
method: PUT
path: "/v1/inbox/conversations/{conversationId}"
tags: ["Inbox"]
---

# Archive or unarchive a conversation

`PUT /v1/inbox/conversations/{conversationId}`

## Request

- Base URL: `https://api.postzen.dev`
- URL: `https://api.postzen.dev/v1/inbox/conversations/{conversationId}`
- Auth: HTTP bearer

Sets the thread’s status. This is PostZen-local state — Meta has no archive API, so nothing is sent to the platform and a later sync never overwrites it. Requires a read-write API key.

## Request body

- InboxConversationUpdateRequest
  - `accountId` string, required: PostZen account id that owns the conversation.
  - `status` 'active' | 'archived', required

## Response `200`

Conversation updated.

- InboxConversationUpdateResponse
  - `success` true, required
  - `data` object, required
    - `id` string, required
    - `accountId` string, required
    - `status` 'active' | 'archived', required
    - `platform` 'instagram', required
    - `updatedAt` string, date-time, required

## Other responses

- `400`: A parameter is missing or malformed — a plain `{ error }` body — or the account is not on a platform direct messages support (`platformUnsupported`).
- `401`: Missing or invalid API key.
- `403`: The account is outside the API key's profile access (`forbidden`), or the connection is missing the messaging scope this call needs (`platformCapabilityMissing`). Reconnect the account to grant it.
- `404`: No such account (`accountNotFound`) or no such conversation for that account (`conversationNotFound`).
- `424`: The connection needs to be reauthorized before its messages can be read (`connectionDead`).
- `429`: Rate limit exceeded. Retry after the interval indicated by the `Retry-After` header.
- `500`: Unexpected server error.

---

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