Verlauf komprimieren (Kontext-Fenster entlasten)

POST

/v1/sessions/{id}/compact

curl --request POST \
  --url https://example.com/v1/sessions/example/compact \
  --header 'Authorization: Bearer <token>'

• Adresse aus config.json → api.addr, Standard 127.0.0.1:2330

Der mittlere Teil der Historie wird per LLM-Zusammenfassung ersetzt, die letzten Turns bleiben wörtlich erhalten. Das ist der Knopf hinter „Komprimieren“ in der Web-UI.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Responses

200

Komprimierte Sitzung.

Media typeapplication/json

object

before_tokens

Geschätzte Token-Zahl vor der Komprimierung

integer

context

object

tokens

Geschätzte Token-Zahl der aktuellen Historie

integer

limit

Effektives Kontextfenster des Modells, gemessen per Benchmark

integer

percent

Tokens / limit * 100

number

session

object

id

string

title

string

title_custom

True nach manueller Umbenennung — die automatische Titel-Vergabe fasst das nicht mehr an

boolean

messages

Array

Message-Felder plus Metadaten (Go embedding).

object

role

string

Allowed values: system user assistant tool

content

string

thinking

string

tool_name

string

model

string

prompt_tokens

integer

output_tokens

integer

at

string format: date-time

last_model

string

total_prompt

integer

total_output

integer

created_at

string format: date-time

updated_at

string format: date-time

Example

{
  "session": {
    "messages": [
      {
        "role": "system"
      }
    ]
  }
}

400

Sitzung hat noch keine Konversation, oder das Zusammenfassen ist fehlgeschlagen.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}

404

Unbekannte Sitzung.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}