---
title: "Trigger Conversation Compaction"
method: POST
path: "/admin/conversations/{conversation_id}/compaction"
tags: ["admin"]
---

# Trigger Conversation Compaction

`POST /admin/conversations/{conversation_id}/compaction`

Enqueue a compaction build for one conversation.

Used to seed a swap-in artifact for huge legacy conversations that never
crossed the scheduler's eligibility thresholds. The build runs on the
worker, uses the latest message at build start as the boundary, and the
next message in the conversation will pick up the active artifact via
`build_thread`.

## Path parameters

- `conversation_id` string, uuid, required

## Response `200`

Successful Response

- ConversationCompactionTriggerResponse
  - `conversation_id` string, required
  - `queued` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)