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

Changes

Changed in 3 of the 3 revisions of this API.57

  • 8eac348b2e662See the full diff
    • ○

      added the new optional query request parameter archived

      new-optional-request-parameter

    • ○

      added the optional property items/archived to the response with the 200 status

      response-optional-property-added

  • 0843dee5b7254See the full diff
    • ○

      added the new optional query request parameter limit

      new-optional-request-parameter

    • ○

      added the new optional query request parameter offset

      new-optional-request-parameter

    • ○

      added the new optional query request parameter q

      new-optional-request-parameter

    • ○

      added the non-success response with the status 422

      response-non-success-status-added

  • c455806f620b51See the full diff
    • ●

      deleted the query request parameter archived

      request-parameter-removed

    • ●

      deleted the query request parameter limit

      request-parameter-removed

    • ●

      deleted the query request parameter offset

      request-parameter-removed

    • ●

      deleted the query request parameter q

      request-parameter-removed

    • ●

      removed the optional property items/archived from the response with the 200 status

      response-optional-property-removed

    • ○

      removed the non-success response with the status 422

      response-non-success-status-removed

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