Sign in
latestOpenAPI 3.1.02026-08-19270462702.4 KB

b92f75fd3b61

agent-chat-sessions

Get Session

Get a specific chat session with all messages.

session_id is typed :class:~uuid.UUID so FastAPI answers 422 at the boundary. A raw string such as e2e-session would otherwise reach a Postgres uuid comparison and surface as a driver conversion 500 (PYTHON-1YS7).

Args: request: FastAPI request used by the rate-limiter. session_id: Chat session primary key. auth: Authenticated caller (read-only). service: Chat-session service.

Returns: ChatSessionWithMessages for the owned session.

Raises: HTTPException: 404 when the session is missing or not owned.

get/mle-agent/sessions/{session_id}

Path parameters

session_idstring uuid required

Response

Successful Response

idstring required
user_idstring required
titlestring required
created_atstring required
updated_atstring required
is_archivedboolean
project_idstring nullable
images_retention_daysinteger nullable

Per-session image retention window in days for this chat's image attachments. NULL inherits the 30-day default; 0 means keep forever.

modal_sandbox_idstring nullable

Modal sandbox id for the persistent MLE agent runtime, if a sandbox is associated with this session.

raw_message_tree_presentboolean

True when the sandbox runtime has persisted a canonical Anthropic message tree for this session. The tree itself is backend-only state (it includes provider request payloads) so we expose only a presence flag that nightly smoke tests can assert on.

is_turn_activeboolean

True when an agent turn is still running for this session. A chat reloaded mid-turn renders a working state and withholds new input instead of looking stalled and inviting a duplicate prompt.

active_turn_started_atstring nullable

When the in-flight turn started, so the UI can show how long it has been running. Null when no turn is active. May be set while is_turn_active is false, which means the stamp is too old to be believed and was left behind by a pod that died mid-turn.