Optional. The labels for the session. This field is used to identify the session in the UI, for example, research assist sessions can set the label to "research assist" to display different icon in the session list.
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
isPinned
boolean
Optional. Whether the session is pinned, pinned session will be displayed on the top of the session list.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[[["\u003cp\u003eSessions represent an external proto definition and have a JSON representation that includes fields like \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003edisplayName\u003c/code\u003e, \u003ccode\u003estate\u003c/code\u003e, \u003ccode\u003euserPseudoId\u003c/code\u003e, \u003ccode\u003eturns\u003c/code\u003e, \u003ccode\u003estartTime\u003c/code\u003e, \u003ccode\u003eendTime\u003c/code\u003e, and \u003ccode\u003eisPinned\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e field is immutable and fully qualified, following the pattern \u003ccode\u003eprojects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003estartTime\u003c/code\u003e and \u003ccode\u003eendTime\u003c/code\u003e fields record the session's duration using a Timestamp format with RFC 3339, providing details about when a session began and concluded.\u003c/p\u003e\n"],["\u003cp\u003eAvailable methods for managing sessions include creating, deleting, getting, listing, and updating sessions, allowing comprehensive control over session lifecycles.\u003c/p\u003e\n"],["\u003cp\u003eSessions can be displayed on top of the session list if the \u003ccode\u003eisPinned\u003c/code\u003e field is set to true.\u003c/p\u003e\n"]]],[],null,["- [Resource: Session](#Session)\n - [JSON representation](#Session.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Session External session proto definition.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"displayName\": string, \"state\": enum (/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.collections.dataStores.sessions#Session.State), \"userPseudoId\": string, \"turns\": [ { object (/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.collections.dataStores.sessions#Session.Turn) } ], \"labels\": [ string ], \"startTime\": string, \"endTime\": string, \"isPinned\": boolean } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*` |\n| `displayName` | `string` Optional. The display name of the session. This field is used to identify the session in the UI. By default, the display name is the first turn query text in the session. |\n| `state` | `enum (`[State](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.collections.dataStores.sessions#Session.State)`)` The state of the session. |\n| `userPseudoId` | `string` A unique identifier for tracking users. |\n| `turns[]` | `object (`[Turn](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.collections.dataStores.sessions#Session.Turn)`)` Turns. |\n| `labels[]` | `string` Optional. The labels for the session. This field is used to identify the session in the UI, for example, research assist sessions can set the label to \"research assist\" to display different icon in the session list. |\n| `startTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. The time the session started. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `endTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. The time the session finished. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `isPinned` | `boolean` Optional. Whether the session is pinned, pinned session will be displayed on the top of the session list. |\n\n| Methods ||\n|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [create](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.dataStores.sessions/create) | Creates a Session. |\n| [delete](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.dataStores.sessions/delete) | Deletes a Session. |\n| [get](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.dataStores.sessions/get) | Gets a Session. |\n| [list](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.dataStores.sessions/list) | Lists all Sessions by their parent [DataStore](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.collections.dataStores#DataStore). |\n| [patch](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.dataStores.sessions/patch) | Updates a Session. |"]]