---
title: "Summarize Agent Conversation"
method: POST
path: "/v1/agents/{agent_id}/summarize"
tags: ["agents"]
---

# Summarize Agent Conversation

`POST /v1/agents/{agent_id}/summarize`

Summarize an agent's conversation history to a target message length.

This endpoint summarizes the current message history for a given agent,
truncating and compressing it down to the specified `max_message_length`.

## Path parameters

- `agent_id` string, required

## Query parameters

- `max_message_length` integer, required — Maximum number of messages to retain after summarization.

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/yu-code666/apis/letta-api.md) · [All operations](https://skmtc.net/yu-code666/apis/letta-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yu-code666/letta-api/versions/6cec99480c13/schema)