Sign in
latestOpenAPI 3.1.02026-08-19270462702.4 KB

b92f75fd3b61

agent-chat-sessions

Create Session

Create a new chat session.

Args: request: FastAPI request used by the rate-limiter. body: Create payload. auth: Authenticated caller. service: Chat-session service.

Returns: ChatSessionResponse for the created session.

post/mle-agent/sessions

Request body

titlestring nullable

Session title (auto-generated if not provided)

first_messagestring nullable

First user message (used for auto-title generation)

project_idstring nullable

Optional project ID to scope the session to

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. Drives image eviction by the nightly cleanup job.

modal_sandbox_idstring nullable

Modal sandbox id for the persistent MLE agent runtime, if a sandbox is associated with this session. Surfaced for nightly smoke tests and observability — never used for client routing.