---
title: "Changes to Generate"
method: POST
path: "/v1/session/generate"
---

# Changes to Generate

`POST /v1/session/generate`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 5 revisions.

- **2026-07-17** `cc76ee2bed1c`: 2 breaking, 14 warning, 30 info
- **2025-05-06** `c0132bcf00a9`: 3 warning, 3 info
- **2025-05-04** `d7e615a9c1d6`: 16 breaking, 13 warning, 23 info

## Changes

- **2026-07-17** `cc76ee2bed1c`: 2 breaking, 14 warning, 30 info
  - removed `#/components/schemas/Usage` from the `messages/items/usage` request property `anyOf` list
  - removed the enum value `retriving` of the request property `messages/items/state`
  - removed the request property `messages/items/message_sub_type`
  - removed the optional property `messages/items/message_sub_type` from the response with the `200` status
  - added the new `end` enum value to the `messages/items/state` response property for the response status `200`
  - added the new `retrieving` enum value to the `messages/items/state` response property for the response status `200`
  - added the new `sec-gemini/canvas` enum value to the `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 `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 `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 `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 `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 `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 `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 `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 `messages/items/mime_type/anyOf[subschema #1: MimeType]/` response property for the response status `200`
  - added the new `undefined` enum value to the `messages/items/state` response property for the response status `200`
  - added the new optional request property `messages/items/created_at`
  - added the new optional request property `messages/items/icon`
  - added the new optional request property `messages/items/text_color`
  - added the new optional request property `messages/items/title`
  - added `#/components/schemas/Usage-Input` to the `messages/items/usage` request property `anyOf` list
  - the `usage` request property default value `{"prompt_tokens":0,"generated_tokens":0,"total_tokens":0}` was removed
  - added the new `end` enum value to the request property `messages/items/state`
  - added the new `retrieving` enum value to the request property `messages/items/state`
  - added the new `sec-gemini/canvas` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `sec-gemini/code` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `sec-gemini/graph` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `sec-gemini/html` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `sec-gemini/image` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `sec-gemini/json` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `sec-gemini/markdown` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `sec-gemini/table` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `sec-gemini/timeline` enum value to the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - added the new `undefined` enum value to the request property `messages/items/state`
  - added the optional property `messages/items/created_at` to the response with the `200` status
  - added the optional property `messages/items/icon` to the response with the `200` status
  - added the optional property `messages/items/text_color` to the response with the `200` status
  - added the optional property `messages/items/title` to the response with the `200` status
  - added the optional property `usage/cached_token_count` to the response with the `200` status
  - added the optional property `usage/prompt_tokens_details` to the response with the `200` status
  - …6 more
- **2025-05-06** `c0132bcf00a9`: 3 warning, 3 info
  - added the new `confirmation_request` enum value to the `messages/items/message_type` response property for the response status `200`
  - added the new `confirmation_response` enum value to the `messages/items/message_type` response property for the response status `200`
  - added the new `source` enum value to the `messages/items/message_type` response property for the response status `200`
  - added the new `confirmation_request` enum value to the request property `messages/items/message_type`
  - added the new `confirmation_response` enum value to the request property `messages/items/message_type`
  - added the new `source` enum value to the request property `messages/items/message_type`
- **2025-05-04** `d7e615a9c1d6`: 16 breaking, 13 warning, 23 info
  - removed `#/components/schemas/Usage-Input` from the `messages/items/usage` request property `anyOf` list
  - removed the enum value `confirmation_request` of the request property `messages/items/message_type`
  - removed the enum value `confirmation_response` of the request property `messages/items/message_type`
  - removed the enum value `end` of the request property `messages/items/state`
  - removed the enum value `retrieving` of the request property `messages/items/state`
  - removed the enum value `sec-gemini/canvas` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `sec-gemini/code` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `sec-gemini/graph` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `sec-gemini/html` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `sec-gemini/image` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `sec-gemini/json` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `sec-gemini/markdown` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `sec-gemini/table` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `sec-gemini/timeline` of the request property `messages/items/mime_type/anyOf[subschema #1: MimeType]/`
  - removed the enum value `source` of the request property `messages/items/message_type`
  - removed the enum value `undefined` of the request property `messages/items/state`
  - removed the request property `messages/items/created_at`
  - removed the request property `messages/items/icon`
  - removed the request property `messages/items/text_color`
  - removed the request property `messages/items/title`
  - removed the optional property `messages/items/created_at` from the response with the `200` status
  - removed the optional property `messages/items/icon` from the response with the `200` status
  - removed the optional property `messages/items/text_color` from the response with the `200` status
  - removed the optional property `messages/items/title` from the response with the `200` status
  - removed the optional property `usage/cached_token_count` from the response with the `200` status
  - removed the optional property `usage/prompt_tokens_details` from the response with the `200` status
  - removed the optional property `usage/thoughts_token_count` from the response with the `200` status
  - removed the optional property `usage/tool_use_prompt_token_count` from the response with the `200` status
  - added the new `retriving` enum value to the `messages/items/state` response property for the response status `200`
  - added the new optional request property `messages/items/message_sub_type`
  - added `#/components/schemas/Usage` to the `messages/items/usage` request property `anyOf` list
  - the `usage` request property default value `{"prompt_tokens":0,"generated_tokens":0,"total_tokens":0}` was added
  - added the new `retriving` enum value to the request property `messages/items/state`
  - added the optional property `messages/items/message_sub_type` to the response with the `200` status
  - added `#/components/schemas/Usage` to the `messages/items/usage` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/Usage-Output` from the `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 `messages/items/message_type` response property for the response status `200`
  - removed the `confirmation_response` enum value from the `messages/items/message_type` response property for the response status `200`
  - removed the `end` enum value from the `messages/items/state` response property for the response status `200`
  - …12 more

---

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