Sign in
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.

Changes

Changed in 2 of the 3 revisions of this API.12

  • b92f75fd3b611See the full diff
    • ▲

      for the path request parameter session_id, the type/format was changed from string/ to string/uuid

      request-parameter-type-changed

    This revision also has 23 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 31dfe831e0792See the full diff
    • ○

      added the optional property active_turn_started_at to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property is_turn_active to the response with the 200 status

      response-optional-property-added