PIpioneer
Finetune Agent
agent-chat-sessions

Create Session

Changed on

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/v1/finetune-agent/sessions

Request

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

Changes