v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB

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.