Skip to main content
POST
Compact Agent Session

Path Parameters

session_id
string
required

Body

application/json

Request a model-generated checkpoint for a persisted conversation.

model
CustomProviderModelSelection · object
required

The model the client believes the session is set to. As on the chat route this is a precondition: the summary is generated with the session's persisted selection, and a mismatch is rejected with HTTP 409 and code agent_session_model_stale.

Response

Successful Response

The checkpoint message this request created. A 200 always means a new checkpoint was persisted; every other outcome is an HTTP 409 whose body's code says why (see AgentSessionConflictError).

data
PhoenixUIMessage · object
required

UIMessage with metadata narrowed to the Phoenix wire shapes.