List Sessions

Changed on Jul 17, 2026

List all sessions

get/v1/session/list

Request

The document declares no server URL.
Auth
none declared

Response

Successful Response

idstring

Session unique ramdom identifier.

user_idstring required

The user ID this session belongs to.

org_idstring required

The organization ID this session belongs to.

ttlinteger required

The time to live of the session in seconds.

languagestring

The iso-code of the session language.

turnsinteger

The number of turns in the session.

namestring required

Human readable session name.

descriptionstring required

A brief description to help users remember what the session is about.

create_timenumber

The Unix timestamp of when the session was created.

update_timenumber

The Unix timestamp of when the session was last updated.

num_messagesinteger

The number of messages in the session.

can_logboolean

Whether the session can be logged or not.

Changes

Jul 17, 2026cc76ee2bed1c Revision changes
- breaking
  the / response's property type changed from integer to number for status
- breaking
  the / response's property type changed from integer to number for status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  added the new end enum value to the /// response property for the response status
- warning
  added the new end enum value to the / response property for the response status
- warning
  added the new retrieving enum value to the /// response property for the response status
- warning
  added the new retrieving enum value to the / response property for the response status
- warning
  added the new sec-gemini/canvas enum value to the //// response property for the response status
- warning
  added the new sec-gemini/code enum value to the //// response property for the response status
- warning
  added the new sec-gemini/graph enum value to the //// response property for the response status
- warning
  added the new sec-gemini/html enum value to the //// response property for the response status
- warning
  added the new sec-gemini/image enum value to the //// response property for the response status
- warning
  added the new sec-gemini/json enum value to the //// response property for the response status
- warning
  added the new sec-gemini/markdown enum value to the //// response property for the response status
- warning
  added the new sec-gemini/table enum value to the //// response property for the response status
- warning
  added the new sec-gemini/timeline enum value to the //// response property for the response status
- warning
  added the new undefined enum value to the /// response property for the response status
- warning
  added the new undefined enum value to the / response property for the response status
- info
  api operation id list_v1_session_list_get removed and replaced with list_sessions_v1_session_list_get
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added to the /// response property anyOf list for the response status
- info
  removed from the /// response property anyOf list for the response status
- info
  the response property //// became required for the status
- info
  the response property //// became required for the status
- info
  the response property //// became required for the status
- info
  the response's property default value true was removed for the status
- info
  the response's property default value false was removed for the status
- info
  the response's property default value {"prompt_tokens":0,"generated_tokens":0,"total_tokens":0} was removed for the status
- info
  removed the retriving enum value from the /// response property for the response status
- info
  removed the retriving enum value from the / response property for the response status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
May 6, 2025c0132bcf00a9 Revision changes
- warning
  removed the optional property // from the response with the status
- warning
  added the new confirmation_request enum value to the /// response property for the response status
- warning
  added the new confirmation_response enum value to the /// response property for the response status
- warning
  added the new source enum value to the /// response property for the response status
- info
  added the optional property // to the response with the status

Operation history (3 revisions)

List Sessions

Request

Response 200OK

Changes

Response