---
title: "Changes to List Sessions"
method: GET
path: "/v1/session/list"
---

# Changes to List Sessions

`GET /v1/session/list`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 5 revisions.

- **2026-07-17** `cc76ee2bed1c`: 2 breaking, 17 warning, 27 info
- **2025-05-06** `c0132bcf00a9`: 4 warning, 1 info
- **2025-05-04** `d7e615a9c1d6`: 3 breaking, 14 warning, 25 info

## Changes

- **2026-07-17** `cc76ee2bed1c`: 2 breaking, 17 warning, 27 info
  - the `items/create_time` response's property type changed from `integer` to `number` for status `200`
  - the `items/update_time` response's property type changed from `integer` to `number` for status `200`
  - removed the optional property `items/messages/items/message_sub_type` from the response with the `200` status
  - removed the optional property `items/model/is_experimental` from the response with the `200` status
  - added the new `end` enum value to the `items/messages/items/state` response property for the response status `200`
  - added the new `end` enum value to the `items/state` response property for the response status `200`
  - added the new `retrieving` enum value to the `items/messages/items/state` response property for the response status `200`
  - added the new `retrieving` enum value to the `items/state` response property for the response status `200`
  - added the new `sec-gemini/canvas` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `sec-gemini/code` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `sec-gemini/graph` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `sec-gemini/html` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `sec-gemini/image` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `sec-gemini/json` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `sec-gemini/markdown` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `sec-gemini/table` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `sec-gemini/timeline` enum value to the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `undefined` enum value to the `items/messages/items/state` response property for the response status `200`
  - added the new `undefined` enum value to the `items/state` response property for the response status `200`
  - api operation id `list_v1_session_list_get` removed and replaced with `list_sessions_v1_session_list_get`
  - added the optional property `items/files/items/content_type_label` to the response with the `200` status
  - added the optional property `items/messages/items/created_at` to the response with the `200` status
  - added the optional property `items/messages/items/icon` to the response with the `200` status
  - added the optional property `items/messages/items/text_color` to the response with the `200` status
  - added the optional property `items/messages/items/title` to the response with the `200` status
  - added the optional property `items/model/description` to the response with the `200` status
  - added the optional property `items/model/use_experimental` to the response with the `200` status
  - added the optional property `items/usage/cached_token_count` to the response with the `200` status
  - added the optional property `items/usage/prompt_tokens_details` to the response with the `200` status
  - added the optional property `items/usage/thoughts_token_count` to the response with the `200` status
  - added the optional property `items/usage/tool_use_prompt_token_count` to the response with the `200` status
  - added `#/components/schemas/Usage-Output` to the `items/messages/items/usage` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/Usage` from the `items/messages/items/usage` response property `anyOf` list for the response status `200`
  - the response property `items/model/toolsets/items/description` became required for the status `200`
  - the response property `items/model/toolsets/items/is_enabled` became required for the status `200`
  - the response property `items/model/toolsets/items/is_experimental` became required for the status `200`
  - the `is_enabled` response's property default value `true` was removed for the status `200`
  - the `is_experimental` response's property default value `false` was removed for the status `200`
  - the `usage` response's property default value `{"prompt_tokens":0,"generated_tokens":0,"total_tokens":0}` was removed for the status `200`
  - removed the `retriving` enum value from the `items/messages/items/state` response property for the response status `200`
  - …6 more
- **2025-05-06** `c0132bcf00a9`: 4 warning, 1 info
  - removed the optional property `items/model/subagents` from the response with the `200` status
  - added the new `confirmation_request` enum value to the `items/messages/items/message_type` response property for the response status `200`
  - added the new `confirmation_response` enum value to the `items/messages/items/message_type` response property for the response status `200`
  - added the new `source` enum value to the `items/messages/items/message_type` response property for the response status `200`
  - added the optional property `items/model/toolsets` to the response with the `200` status
- **2025-05-04** `d7e615a9c1d6`: 3 breaking, 14 warning, 25 info
  - removed the required property `items/files/items/sha256` from the response with the `200` status
  - removed the required property `items/files/items/size` from the response with the `200` status
  - removed the required property `items/model/model_name` from the response with the `200` status
  - removed the optional property `items/files/items/content_type_label` from the response with the `200` status
  - removed the optional property `items/messages/items/created_at` from the response with the `200` status
  - removed the optional property `items/messages/items/icon` from the response with the `200` status
  - removed the optional property `items/messages/items/text_color` from the response with the `200` status
  - removed the optional property `items/messages/items/title` from the response with the `200` status
  - removed the optional property `items/model/description` from the response with the `200` status
  - removed the optional property `items/model/toolsets` from the response with the `200` status
  - removed the optional property `items/model/use_experimental` from the response with the `200` status
  - removed the optional property `items/usage/cached_token_count` from the response with the `200` status
  - removed the optional property `items/usage/prompt_tokens_details` from the response with the `200` status
  - removed the optional property `items/usage/thoughts_token_count` from the response with the `200` status
  - removed the optional property `items/usage/tool_use_prompt_token_count` from the response with the `200` status
  - added the new `retriving` enum value to the `items/messages/items/state` response property for the response status `200`
  - added the new `retriving` enum value to the `items/state` response property for the response status `200`
  - api operation id `list_sessions_v1_session_list_get` removed and replaced with `list_v1_session_list_get`
  - added the optional property `items/messages/items/message_sub_type` to the response with the `200` status
  - added the optional property `items/model/is_experimental` to the response with the `200` status
  - added the optional property `items/model/subagents` to the response with the `200` status
  - added `#/components/schemas/Usage` to the `items/messages/items/usage` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/Usage-Output` from the `items/messages/items/usage` response property `anyOf` list for the response status `200`
  - the `usage` response's property default value `{"prompt_tokens":0,"generated_tokens":0,"total_tokens":0}` was added for the status `200`
  - removed the `confirmation_request` enum value from the `items/messages/items/message_type` response property for the response status `200`
  - removed the `confirmation_response` enum value from the `items/messages/items/message_type` response property for the response status `200`
  - removed the `end` enum value from the `items/messages/items/state` response property for the response status `200`
  - removed the `end` enum value from the `items/state` response property for the response status `200`
  - removed the `retrieving` enum value from the `items/messages/items/state` response property for the response status `200`
  - removed the `retrieving` enum value from the `items/state` response property for the response status `200`
  - removed the `sec-gemini/canvas` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `sec-gemini/code` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `sec-gemini/graph` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `sec-gemini/html` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `sec-gemini/image` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `sec-gemini/json` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `sec-gemini/markdown` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `sec-gemini/table` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `sec-gemini/timeline` enum value from the `items/messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - removed the `source` enum value from the `items/messages/items/message_type` response property for the response status `200`
  - …2 more

---

[Operation](https://skmtc.dev/google/apis/sec-gemini/docs/v1/session/list/get.md) - [API](https://skmtc.dev/google/apis/sec-gemini.md) - [Page](https://skmtc.dev/google/apis/sec-gemini/changes/v1/session/list/get)
