## Python SDK Changes:

* `glean.client.chat.create()`: 
  *  `request.messages[].citations[].source_document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
  *  `response` **Changed** (Breaking ⚠️)
* `glean.client.pins.update()`:  `response.attribution.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.announcements.update()`: 
  *  `request.body.structured_list[].document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
  *  `response.body.structured_list[].document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.answers.create()`: 
  *  `request.data.added_roles[].group.type.enum(collection_audience)` **Added**
  *  `response.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.answers.update()`: 
  *  `request.added_roles[].group.type.enum(collection_audience)` **Added**
  *  `response.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.answers.retrieve()`:  `response.answer_result.answer.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.answers.list()`:  `response.answer_results[].answer.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.announcements.create()`: 
  *  `request.body.structured_list[].document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
  *  `response.body.structured_list[].document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.chat.retrieve()`:  `response.chat_result.chat.created_by.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.chat.list()`:  `response.chat_results[].chat.created_by.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.chat.create_stream()`: 
  *  `request.messages[].citations[].source_document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.collections.add_items()`:  `response.collection.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.collections.create()`: 
  *  `request.added_roles[].group.type.enum(collection_audience)` **Added**
  *  `response.union(class (0)).collection.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.collections.delete_item()`:  `response.collection.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.collections.update()`: 
  *  `request.added_roles[].group.type.enum(collection_audience)` **Added**
  *  `response.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.collections.update_item()`:  `response.collection.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.collections.retrieve()`:  `response.collection.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.collections.list()`:  `response.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.documents.retrieve()`:  `response.documents.Map<DocumentOrError>.union(Document).metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.documents.retrieve_by_facets()`:  `response.documents[].metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.insights.retrieve()`:  `response.glean_assist.activity_insights[].user.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.pins.retrieve()`:  `response.pin.attribution.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.messages.retrieve()`:  `response.search_response.results[].structured_results[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.agents.create_agent()`: **Added**
* `glean.client.pins.list()`:  `response.pins[].attribution.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.pins.create()`:  `response.attribution.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.search.query_as_admin()`: 
  *  `request.source_document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
  *  `response.results[].structured_results[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.search.autocomplete()`:  `response.results[].document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.search.retrieve_feed()`: 
  *  `request.categories[].enum(card_stack_promo)` **Added**
  *  `response.results[]` **Changed**
* `glean.client.search.recommendations()`: 
  *  `request.source_document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
  *  `response.results[].structured_results[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.search.query()`: 
  *  `request.source_document.metadata.author.related_documents[].results[].structured_results[].custom_entity.roles[].group.type.enum(collection_audience)` **Added**
  *  `response.results[].structured_results[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.entities.list()`:  `response.results[].related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.entities.read_people()`:  `response.results[].related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.shortcuts.create()`: 
  *  `request.data.added_roles[].group.type.enum(collection_audience)` **Added**
  *  `response.shortcut.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.shortcuts.retrieve()`:  `response.shortcut.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.shortcuts.list()`:  `response.shortcuts[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.shortcuts.update()`: 
  *  `request.added_roles[].group.type.enum(collection_audience)` **Added**
  *  `response.shortcut.added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.verification.add_reminder()`:  `response.metadata.last_verifier.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.verification.list()`:  `response.documents[].metadata.last_verifier.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.verification.verify()`:  `response.metadata.last_verifier.related_documents[].query_suggestion.ranges[].document.metadata.collections[].added_roles[].group.type.enum(collection_audience)` **Added**
* `glean.client.governance.data.policies.retrieve()`:  `response.report.config.allowlist_options.regexes` **Added**
* `glean.client.governance.data.policies.update()`: 
  *  `request.config.allowlist_options.regexes` **Added**
* `glean.client.governance.data.policies.list()`:  `response.reports[].config.allowlist_options.regexes` **Added**
* `glean.client.governance.data.policies.create()`: 
  *  `request.config.allowlist_options.regexes` **Added**
  *  `response.report.config.allowlist_options.regexes` **Added**
* `glean.client.governance.data.reports.create()`: 
  *  `request.config.allowlist_options.regexes` **Added**

Author: speakeasybot

.speakeasy/gen.lock

@@ -34,7 +34,7 @@ generation:
     generateNewTests: true
     skipResponseBodyAssertions: true
 python:
-  version: 0.13.0
+  version: 0.13.1
   additionalDependencies:
     dev: {}
     main: {}
@@ -54,6 +54,10 @@ python:
   enableCustomCodeRegions: false
   enumFormat: enum
   envVarPrefix: GLEAN
+  errorSchemaValidation: true
+  eventStreamClassNames:
+    async: EventStreamAsync
+    sync: EventStream
   fixFlags:
     asyncPaginationSep2025: false
     conflictResistantModelImportsFeb2026: false
@@ -73,6 +77,7 @@ python:
       webhooks: ""
   inferUnionDiscriminators: true
   inputModelSuffix: input
+  inputTypedDictSuffix: TypedDict
   legacyPyright: true
   license: ""
   maxMethodParams: 999

.speakeasy/gen.yaml

@@ -2,7 +2,7 @@ openapi: 3.0.0
 info:
   version: 0.9.0
   title: Glean API
-  x-source-commit-sha: deacbe1e0fd0b5074c1b1445f05b4a5df529f487
+  x-source-commit-sha: e5874b89189ffca39bde70621d5ea19c1e418b92
   description: |
     # Introduction
     In addition to the data sources that Glean has built-in support for, Glean also provides a REST API that enables customers to put arbitrary content in the search index. This is useful, for example, for doing permissions-aware search over content in internal tools that reside on-prem as well as for searching over applications that Glean does not currently support first class. In addition these APIs allow the customer to push organization data (people info, organization structure etc) into Glean.
@@ -22,7 +22,7 @@ info:
     These API clients provide type-safe, idiomatic interfaces for working with Glean IndexingAPIs in your language of choice.
   x-logo:
     url: https://app.glean.com/images/glean-text2.svg
-  x-open-api-commit-sha: 7de1c5956c93a8bdd7b4a2c6a4c6fd98b0c4df70
+  x-open-api-commit-sha: 23532a93a618e97b01af0fd230491a9dc452c543
   x-speakeasy-name: 'Glean API'
 servers:
   - url: https://{instance}-be.glean.com
@@ -569,6 +569,23 @@ paths:
                                     startIndex: 0
                                     endIndex: 12
                                     type: CITATION
+        "202":
+          description: |
+            Request accepted but not yet processed. Returned when another
+            in-flight request is already running for the same chat session;
+            the body's `queuedRequestId` identifies the deferred run and
+            output will be persisted to the chat session referenced by
+            `chatId`.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ChatResponse"
+              examples:
+                queuedExample:
+                  value:
+                    chatId: abc123
+                    queuedRequestId: qr-xyz
+                    isSavedToChatHistory: true
         "400":
           description: Invalid request
         "401":
@@ -893,6 +910,40 @@ paths:
           description: Internal server error.
       security:
         - APIToken: []
+  /rest/api/v1/agents:
+    post:
+      tags:
+        - Agents
+      summary: Create an agent
+      description: Create an agent.
+      operationId: createAgent
+      x-visibility: Preview
+      parameters:
+        - $ref: "#/components/parameters/locale"
+        - $ref: "#/components/parameters/timezoneOffset"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateWorkflowRequest"
+      responses:
+        "200":
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CreateWorkflowResponse"
+        "400":
+          description: Bad request
+        "401":
+          description: Not Authorized
+        "403":
+          description: Forbidden
+        "500":
+          description: Internal server error
+      security:
+        - APIToken: []
   /rest/api/v1/agents/{agent_id}:
     get:
       tags:
@@ -1090,7 +1141,7 @@ paths:
             text/event-stream:
               schema:
                 type: string
-                description: The server will send a stream of events in server-sent events (SSE) format.
+                description: The server will send a stream of events in server-sent events (SSE) format. If execution fails after the stream has started, the stream may terminate with an error message in a normal `message` event.
                 example: |
                   id: 1
                   event: message
@@ -4658,6 +4709,8 @@ components:
     APIToken:
       scheme: bearer
       type: http
+      description: >-
+        HTTP bearer token. Accepts a Glean-issued API token, an OAuth access token from the Glean OAuth Authorization Server (including Dynamic Client Registration clients), or an OAuth access token issued by an external identity provider. External-IdP OAuth tokens must also include the `X-Glean-Auth-Type: OAUTH` request header. OAuth is supported on the Client API only; the Indexing API requires a Glean-issued token.
   schemas:
     ActivityEventParams:
       properties:
@@ -6002,6 +6055,8 @@ components:
     GroupType:
       type: string
       description: The type of user group
+      x-enumDescriptions:
+        COLLECTION_AUDIENCE: Refers to any viewers of the Collection.
       enum:
         - DEPARTMENT
         - ALL
@@ -6011,6 +6066,9 @@ components:
         - LOCATION
         - REGION
         - EXTERNAL_GROUP
+        - COLLECTION_AUDIENCE
+      x-speakeasy-enum-descriptions:
+        COLLECTION_AUDIENCE: Refers to any viewers of the Collection.
     Group:
       required:
         - type
@@ -8973,6 +9031,80 @@ components:
           items:
             type: string
           description: IDs of files to delete.
+    WorkflowDraftableProperties:
+      properties:
+        name:
+          type: string
+          description: The name of the workflow.
+    WorkflowMutableProperties:
+      type: object
+      allOf:
+        - $ref: "#/components/schemas/WorkflowDraftableProperties"
+        - type: object
+    CreateWorkflowRequest:
+      allOf:
+        - $ref: "#/components/schemas/WorkflowMutableProperties"
+        - type: object
+          properties:
+            transient:
+              type: boolean
+              description: Used to create a transient workflow.
+            parentWorkflowId:
+              type: string
+              description: id of the parent workflow for transient workflows
+    WorkflowMetadata:
+      allOf:
+        - type: object
+          properties:
+            author:
+              $ref: "#/components/schemas/Person"
+            createTimestamp:
+              type: integer
+              description: Server Unix timestamp of the creation time.
+            lastUpdateTimestamp:
+              type: integer
+              description: Server Unix timestamp of the last update time.
+            lastDraftSavedAt:
+              type: integer
+              description: Server Unix timestamp of the last time the draft was saved.
+            lastDraftSavedBy:
+              description: The person who last saved the draft.
+              $ref: "#/components/schemas/Person"
+            lastDraftGitAuthorId:
+              type: string
+              description: ID of the VCS user (e.g. GitHub username) who last saved the draft. Set only by the draft save path via the external Git integration API.
+            lastUpdatedBy:
+              $ref: "#/components/schemas/Person"
+    AttributionProperties: {}
+    Workflow:
+      allOf:
+        - $ref: "#/components/schemas/PermissionedObject"
+        - $ref: "#/components/schemas/WorkflowMutableProperties"
+        - $ref: "#/components/schemas/WorkflowMetadata"
+        - $ref: "#/components/schemas/AttributionProperties"
+        - type: object
+          properties:
+            id:
+              type: string
+              description: The ID of the workflow.
+            verified:
+              type: boolean
+              readOnly: true
+              description: When present, indicates this workflow is admin-verified. Set via the dedicated admin settings endpoint, not by regular edits.
+            showOrganizationAsAuthor:
+              type: boolean
+              readOnly: true
+              description: When true, displays organization name instead of author name in agent card. Set via the dedicated admin settings endpoint, not by regular edits.
+    WorkflowResult:
+      type: object
+      required:
+        - workflow
+      properties:
+        workflow:
+          $ref: "#/components/schemas/Workflow"
+    CreateWorkflowResponse:
+      allOf:
+        - $ref: "#/components/schemas/WorkflowResult"
     Agent:
       title: Agent
       type: object
@@ -9025,16 +9157,6 @@ components:
         message:
           type: string
           description: Client-facing error message describing what went wrong
-    WorkflowDraftableProperties:
-      properties:
-        name:
-          type: string
-          description: The name of the workflow.
-    WorkflowMutableProperties:
-      type: object
-      allOf:
-        - $ref: "#/components/schemas/WorkflowDraftableProperties"
-        - type: object
     EditWorkflowRequest:
       allOf:
         - $ref: "#/components/schemas/WorkflowMutableProperties"
@@ -10985,6 +11107,7 @@ components:
               - MID_DAY_CATCH_UP
               - QUERY_SUGGESTION
               - COWORK_CUJ_PROMO
+              - CARD_STACK_PROMO
               - WEEKLY_MEETINGS
               - FOLLOW_UP
               - MILESTONE_TIMELINE_CHECK
@@ -11293,7 +11416,6 @@ components:
           description: A list of removed user roles for the Workflow.
           items:
             $ref: "#/components/schemas/UserRoleSpecification"
-    AttributionProperties: {}
     PromptTemplate:
       allOf:
         - $ref: "#/components/schemas/PromptTemplateMutableProperties"
@@ -11369,55 +11491,6 @@ components:
         runCount:
           $ref: "#/components/schemas/CountInfo"
           description: This tracks how many times this prompt template was run. If user runs a prompt template after modifying the original one, it still counts as a run for the original template.
-    WorkflowMetadata:
-      allOf:
-        - type: object
-          properties:
-            author:
-              $ref: "#/components/schemas/Person"
-            createTimestamp:
-              type: integer
-              description: Server Unix timestamp of the creation time.
-            lastUpdateTimestamp:
-              type: integer
-              description: Server Unix timestamp of the last update time.
-            lastDraftSavedAt:
-              type: integer
-              description: Server Unix timestamp of the last time the draft was saved.
-            lastDraftSavedBy:
-              description: The person who last saved the draft.
-              $ref: "#/components/schemas/Person"
-            lastDraftGitAuthorId:
-              type: string
-              description: ID of the VCS user (e.g. GitHub username) who last saved the draft. Set only by the draft save path via the external Git integration API.
-            lastUpdatedBy:
-              $ref: "#/components/schemas/Person"
-    Workflow:
-      allOf:
-        - $ref: "#/components/schemas/PermissionedObject"
-        - $ref: "#/components/schemas/WorkflowMutableProperties"
-        - $ref: "#/components/schemas/WorkflowMetadata"
-        - $ref: "#/components/schemas/AttributionProperties"
-        - type: object
-          properties:
-            id:
-              type: string
-              description: The ID of the workflow.
-            verified:
-              type: boolean
-              readOnly: true
-              description: When present, indicates this workflow is admin-verified. Set via the dedicated admin settings endpoint, not by regular edits.
-            showOrganizationAsAuthor:
-              type: boolean
-              readOnly: true
-              description: When true, displays organization name instead of author name in agent card. Set via the dedicated admin settings endpoint, not by regular edits.
-    WorkflowResult:
-      type: object
-      required:
-        - workflow
-      properties:
-        workflow:
-          $ref: "#/components/schemas/Workflow"
     UserActivity:
       properties:
         actor:
@@ -11514,6 +11587,7 @@ components:
             - MID_DAY_CATCH_UP
             - QUERY_SUGGESTION
             - COWORK_CUJ_PROMO
+            - CARD_STACK_PROMO
             - WEEKLY_MEETINGS
             - FOLLOW_UP
             - MILESTONE_TIMELINE_CHECK
@@ -11602,6 +11676,7 @@ components:
             - MID_DAY_CATCH_UP
             - QUERY_SUGGESTION
             - COWORK_CUJ_PROMO
+            - CARD_STACK_PROMO
             - WEEKLY_MEETINGS
             - FOLLOW_UP
             - MILESTONE_TIMELINE_CHECK
@@ -11622,6 +11697,12 @@ components:
         rank:
           type: integer
           description: Rank of the result. Rank is suggested by server. Client side rank may differ.
+        placementReason:
+          type: string
+          enum:
+            - ORGANIC
+            - PROMO
+          description: Placement source for ranked feed results. ORGANIC means the card was emitted by normal feed ranking. PROMO means the card was inserted by the homepage cards promo framework.
     FeedResponse:
       required:
         - serverTimestamp
@@ -14272,7 +14353,12 @@ components:
           items:
             type: string
           description: list of words and phrases to consider as whitelisted content
-      description: Terms that are allow-listed during the scans. If any finding picked up by a rule exactly matches a term in the allow-list, it will not be counted as a violation.
+        regexes:
+          type: array
+          items:
+            type: string
+          description: list of regular expressions whose matches are considered whitelisted content
+      description: Terms and regexes that are allow-listed during the scans. If any finding picked up by a rule exactly matches a term, or matches a regex, in the allow-list, it will not be counted as a violation.
     DlpConfig:
       properties:
         version:

.speakeasy/glean-merged-spec.yaml

@@ -158705,3 +158705,19 @@ workflows:
               type: simple
       x-speakeasy-test-group: Datasources
       x-speakeasy-test-rebuild: true
+    - workflowId: createAgent
+      steps:
+        - stepId: test
+          operationId: createAgent
+          requestBody:
+            contentType: application/json
+            payload: {}
+          successCriteria:
+            - condition: $statusCode == 200
+            - condition: $response.header.Content-Type == application/json
+            - context: $response.body
+              condition: |
+                {"workflow":{"author":{"name":"George Clooney","obfuscatedId":"abc123"},"lastDraftSavedBy":{"name":"George Clooney","obfuscatedId":"abc123"},"lastUpdatedBy":{"name":"George Clooney","obfuscatedId":"abc123"}}}
+              type: simple
+      x-speakeasy-test-group: Agents
+      x-speakeasy-test-rebuild: true