---
title: "Compact a conversation"
method: POST
path: "/api/w/{wId}/assistant/conversations/{cId}/compactions"
tags: ["Private Conversations"]
---

# Compact a conversation

`POST /api/w/{wId}/assistant/conversations/{cId}/compactions`

Trigger compaction of a conversation, summarizing older messages into a compaction message. Requires a model to use for summary generation.

## Path parameters

- `wId` string, required
- `cId` string, required

## Request body

- object
  - `model` object, required
    - `providerId` string, required
    - `modelId` string, required

## Response `200`

Compaction started

- object
  - `compactionMessage` PrivateCompactionMessage — A compaction message summarizing earlier conversation content.
    - `type` 'compaction_message', required
    - `id` integer
    - `compactionMessageId` integer
    - `sId` string, required
    - `created` integer, required
    - `visibility` 'visible' | 'deleted'
    - `version` integer, required
    - `rank` integer, required
    - `branchId` string, nullable — Legacy, always null. Branches were removed.
    - `sourceConversationId` string, nullable
    - `status` 'created' | 'succeeded' | 'failed', required
    - `content` string, nullable — Compacted summary. Null while status is "created".

## Other responses

- `400` — Invalid request body
- `404` — Conversation not found
- `409` — Conflict — compaction or agent message is already running

---

[API](https://skmtc.net/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.net/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/versions/5834d690c29d/schema)