v1

latestOpenAPI 3.1.02026-07-17182335.0 KB

sessions

List all sessions

List sessions with optional pagination and search.

Args: limit: Maximum number of sessions to return (default 100, max 500). offset: Number of sessions to skip (default 0). q: Optional search query to filter by title or work_dir. archived: Filter by archived status. - None (default): Only return non-archived sessions. - True: Only return archived sessions.

get/api/sessions/

Query parameters

limitinteger

offsetinteger

qstring nullable

archivedboolean nullable

Response

Successful Response

session_idstring uuid required

Session unique ID

titlestring required

Session title derived from kimi-cli history

last_updatedstring date-time required

Last updated timestamp

is_runningboolean

Whether the session is running

work_dirstring nullable

Working directory for the session

session_dirstring nullable

Session directory path

archivedboolean

Whether the session is archived