Skip to content

Commit 86efe55

Browse files
committed
## Python SDK Changes:
* `glean.datasources.get_datasource_instance_configuration()`: **Added** * `glean.datasources.update_datasource_instance_configuration()`: **Added** * `glean.client.agents.retrieve()`: `error.status[404]` **Added** * `glean.client.agents.retrieve_schemas()`: * `response.tools[]` **Changed** * `error` **Changed** * `glean.client.agents.list()`: `error` **Changed** * `glean.client.agents.run_stream()`: `error` **Changed** * `glean.indexing.people.bulk_index()`: **Deprecated**
1 parent 128c3ef commit 86efe55

File tree

166 files changed

+3667
-882
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

166 files changed

+3667
-882
lines changed

.speakeasy/gen.lock

Lines changed: 385 additions & 271 deletions
Large diffs are not rendered by default.

.speakeasy/gen.yaml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ generation:
1717
securityFeb2025: true
1818
sharedErrorComponentsApr2025: true
1919
sharedNestedComponentsJan2026: false
20+
nameOverrideFeb2026: false
2021
auth:
2122
oAuth2ClientCredentialsEnabled: false
2223
oAuth2PasswordEnabled: false
@@ -33,7 +34,7 @@ generation:
3334
generateNewTests: true
3435
skipResponseBodyAssertions: true
3536
python:
36-
version: 0.12.8
37+
version: 0.12.9
3738
additionalDependencies:
3839
dev: {}
3940
main: {}

.speakeasy/glean-merged-spec.yaml

Lines changed: 201 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ openapi: 3.0.0
22
info:
33
version: 0.9.0
44
title: Glean API
5-
x-source-commit-sha: 56c08697ca3b6869022a262114e61f1385914425
5+
x-source-commit-sha: ab63403c556e8f9300544da1782dab2aa126a90e
66
description: |
77
# Introduction
88
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:
2222
These API clients provide type-safe, idiomatic interfaces for working with Glean IndexingAPIs in your language of choice.
2323
x-logo:
2424
url: https://app.glean.com/images/glean-text2.svg
25-
x-open-api-commit-sha: daa8736a6f0763faffd2c1079da8a42345536ed7
25+
x-open-api-commit-sha: 40468ef09031270e410c9734f90ff6ba397e1dc6
2626
x-speakeasy-name: 'Glean API'
2727
servers:
2828
- url: https://{instance}-be.glean.com
@@ -3122,6 +3122,13 @@ paths:
31223122
description: Not Authorized
31233123
"409":
31243124
description: Conflict
3125+
deprecated: true
3126+
x-speakeasy-deprecation-message: "Deprecated on 2026-02-03, removal scheduled for 2026-10-15: Endpoint is deprecated"
3127+
x-glean-deprecated:
3128+
id: ce596f49-55c4-465e-bf3c-5a3a33906e1f
3129+
introduced: "2026-02-03"
3130+
message: Endpoint is deprecated
3131+
removal: "2026-10-15"
31253132
x-speakeasy-name-override: bulkIndex
31263133
x-speakeasy-group: indexing.people
31273134
/api/index/v1/indexemployeelist: {}
@@ -3676,6 +3683,89 @@ paths:
36763683
"500":
36773684
description: Internal error
36783685
x-visibility: Public
3686+
/rest/api/v1/configure/datasources/{datasourceId}/instances/{instanceId}:
3687+
get:
3688+
operationId: getDatasourceInstanceConfiguration
3689+
summary: Get datasource instance configuration
3690+
description: |
3691+
Gets the greenlisted configuration values for a datasource instance. Returns only configuration keys that are exposed via the public API greenlist.
3692+
tags:
3693+
- Datasources
3694+
parameters:
3695+
- $ref: '#/components/parameters/datasourceId'
3696+
- $ref: '#/components/parameters/instanceId'
3697+
responses:
3698+
"200":
3699+
description: OK
3700+
content:
3701+
application/json:
3702+
schema:
3703+
$ref: '#/components/schemas/DatasourceConfigurationResponse'
3704+
"400":
3705+
description: Invalid request
3706+
content:
3707+
application/json:
3708+
schema:
3709+
$ref: '#/components/schemas/ErrorResponse'
3710+
"401":
3711+
description: Not authorized
3712+
"403":
3713+
description: Forbidden
3714+
content:
3715+
application/json:
3716+
schema:
3717+
$ref: '#/components/schemas/ErrorResponse'
3718+
"404":
3719+
description: Datasource instance not found
3720+
content:
3721+
application/json:
3722+
schema:
3723+
$ref: '#/components/schemas/ErrorResponse'
3724+
x-visibility: Preview
3725+
patch:
3726+
operationId: updateDatasourceInstanceConfiguration
3727+
summary: Update datasource instance configuration
3728+
description: |
3729+
Updates the greenlisted configuration values for a datasource instance. Only configuration keys that are exposed via the public API greenlist may be set. Returns the full greenlisted configuration after the update is applied.
3730+
tags:
3731+
- Datasources
3732+
parameters:
3733+
- $ref: '#/components/parameters/datasourceId'
3734+
- $ref: '#/components/parameters/instanceId'
3735+
requestBody:
3736+
content:
3737+
application/json:
3738+
schema:
3739+
$ref: '#/components/schemas/UpdateDatasourceConfigurationRequest'
3740+
required: true
3741+
responses:
3742+
"200":
3743+
description: OK
3744+
content:
3745+
application/json:
3746+
schema:
3747+
$ref: '#/components/schemas/DatasourceConfigurationResponse'
3748+
"400":
3749+
description: Invalid request
3750+
content:
3751+
application/json:
3752+
schema:
3753+
$ref: '#/components/schemas/ErrorResponse'
3754+
"401":
3755+
description: Not authorized
3756+
"403":
3757+
description: Forbidden
3758+
content:
3759+
application/json:
3760+
schema:
3761+
$ref: '#/components/schemas/ErrorResponse'
3762+
"404":
3763+
description: Datasource instance not found
3764+
content:
3765+
application/json:
3766+
schema:
3767+
$ref: '#/components/schemas/ErrorResponse'
3768+
x-visibility: Preview
36793769
/rest/api/v1/chat#stream:
36803770
post:
36813771
tags:
@@ -6547,16 +6637,34 @@ components:
65476637
deprecated: true
65486638
description: The person that invited this person.
65496639
$ref: "#/components/schemas/Person"
6640+
x-glean-deprecated:
6641+
id: 1d3cd23f-9085-4378-b466-9bdc2e344a71
6642+
introduced: "2026-02-05"
6643+
message: Use ChannelInviteInfo instead
6644+
removal: "2026-10-15"
6645+
x-speakeasy-deprecation-message: "Deprecated on 2026-02-05, removal scheduled for 2026-10-15: Use ChannelInviteInfo instead"
65506646
inviteTime:
65516647
deprecated: true
65526648
type: string
65536649
format: date-time
65546650
description: The time this person was invited in ISO format (ISO 8601).
6651+
x-glean-deprecated:
6652+
id: 2dc3f572-cded-483d-af07-fc9fc7fd0ae4
6653+
introduced: "2026-02-05"
6654+
message: Use ChannelInviteInfo instead
6655+
removal: "2026-10-15"
6656+
x-speakeasy-deprecation-message: "Deprecated on 2026-02-05, removal scheduled for 2026-10-15: Use ChannelInviteInfo instead"
65556657
reminderTime:
65566658
deprecated: true
65576659
type: string
65586660
format: date-time
65596661
description: The time this person was reminded in ISO format (ISO 8601) if a reminder was sent.
6662+
x-glean-deprecated:
6663+
id: d02d58cf-eb90-45d0-ab90-f7a9d707ae3c
6664+
introduced: "2026-02-05"
6665+
message: Use ChannelInviteInfo instead
6666+
removal: "2026-10-15"
6667+
x-speakeasy-deprecation-message: "Deprecated on 2026-02-05, removal scheduled for 2026-10-15: Use ChannelInviteInfo instead"
65606668
ReadPermission:
65616669
description: Describes the read permission level that a user has for a specific feature
65626670
properties:
@@ -8107,9 +8215,12 @@ components:
81078215
description: Whether the agent supports streaming output. If true, you you can stream agent ouput. All agents currently support streaming.
81088216
additionalProperties: true
81098217
ErrorResponse:
8110-
type: string
8111-
title: ErrorResponse
8112-
description: Error message returned from the server
8218+
type: object
8219+
description: Error response returned for failed requests
8220+
properties:
8221+
message:
8222+
type: string
8223+
description: Client-facing error message describing what went wrong
81138224
ActionSummary:
81148225
type: object
81158226
description: Represents a minimal summary of an action.
@@ -8123,6 +8234,32 @@ components:
81238234
display_name:
81248235
type: string
81258236
description: The display name of the action.
8237+
type:
8238+
type: string
8239+
description: The type of tool - RETRIEVAL for read-only operations, ACTION for operations that modify data.
8240+
auth_type:
8241+
type: string
8242+
description: The authentication type required - OAUTH_USER, OAUTH_ADMIN, API_KEY, BASIC_AUTH, DWD (domain-wide delegation), or NONE.
8243+
write_action_type:
8244+
type: string
8245+
description: For write actions only - REDIRECT (client renders URL) or EXECUTION (external server call).
8246+
is_setup_finished:
8247+
type: boolean
8248+
description: Whether this action has been fully configured and validated.
8249+
x-includeEmpty: true
8250+
data_source:
8251+
type: string
8252+
description: |
8253+
Indicates the kind of knowledge a tool would access or modify.
8254+
Company knowledge:
8255+
- Glean search, and any native tools that derive from it (e.g., expert search, code search)
8256+
- Native federated tools to company data sources (e.g., outlook search)
8257+
World knowledge:
8258+
- Native tools that bring in public content (e.g., web browser)
8259+
- Platform action like bingwebsearch, geminiwebsearch, etc
8260+
Neutral knowledge:
8261+
- Native tools that don't access or modify content via APIs (e.g., file analyst, think)
8262+
- Platform read or write tools (creator has to determine their knowledge implications)
81268263
AgentSchemas:
81278264
properties:
81288265
agent_id:
@@ -13217,6 +13354,49 @@ components:
1321713354
items:
1321813355
type: string
1321913356
description: List of field names to exclude from the export
13357+
ConfigurationValue:
13358+
type: object
13359+
properties:
13360+
value:
13361+
type: string
13362+
description: The configuration value as a string. Only one of value or valueList should be populated.
13363+
valueList:
13364+
type: array
13365+
items:
13366+
type: string
13367+
description: The configuration value as a list of strings. Only one of value or valueList should be populated.
13368+
description: A single configuration value, either a scalar or a list
13369+
ConfigurationValues:
13370+
type: object
13371+
additionalProperties:
13372+
$ref: '#/components/schemas/ConfigurationValue'
13373+
description: A map from configuration key names to their values
13374+
DatasourceInstanceConfiguration:
13375+
type: object
13376+
properties:
13377+
values:
13378+
$ref: '#/components/schemas/ConfigurationValues'
13379+
required:
13380+
- values
13381+
description: Configuration for a datasource instance
13382+
DatasourceConfigurationResponse:
13383+
type: object
13384+
properties:
13385+
configuration:
13386+
$ref: '#/components/schemas/DatasourceInstanceConfiguration'
13387+
required:
13388+
- configuration
13389+
description: |
13390+
The greenlisted configuration values for a datasource instance. Only keys that are exposed via the public API greenlist are included.
13391+
UpdateDatasourceConfigurationRequest:
13392+
type: object
13393+
properties:
13394+
configuration:
13395+
$ref: '#/components/schemas/DatasourceInstanceConfiguration'
13396+
required:
13397+
- configuration
13398+
description: |
13399+
Request to update greenlisted configuration values for a datasource instance. Only keys that are exposed via the public API greenlist may be set.
1322013400
ChatRequestStream:
1322113401
required:
1322213402
- messages
@@ -13274,6 +13454,22 @@ components:
1327413454
description: The offset of the client's timezone in minutes from UTC. e.g. PDT is -420 because it's 7 hours behind UTC.
1327513455
schema:
1327613456
type: integer
13457+
datasourceId:
13458+
name: datasourceId
13459+
in: path
13460+
description: The datasource type identifier (e.g. o365sharepoint)
13461+
required: true
13462+
schema:
13463+
type: string
13464+
example: o365sharepoint
13465+
instanceId:
13466+
name: instanceId
13467+
in: path
13468+
description: The datasource instance identifier
13469+
required: true
13470+
schema:
13471+
type: string
13472+
example: o365sharepoint_abc123
1327713473
responses:
1327813474
SuccessResponse:
1327913475
description: OK

.speakeasy/tests.arazzo.yaml

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158449,3 +158449,48 @@ workflows:
158449158449
type: simple
158450158450
x-speakeasy-test-group: Authentication
158451158451
x-speakeasy-test-rebuild: true
158452+
- workflowId: getDatasourceInstanceConfiguration
158453+
steps:
158454+
- stepId: test
158455+
operationId: getDatasourceInstanceConfiguration
158456+
parameters:
158457+
- name: datasourceId
158458+
in: path
158459+
value: o365sharepoint
158460+
- name: instanceId
158461+
in: path
158462+
value: o365sharepoint_abc123
158463+
successCriteria:
158464+
- condition: $statusCode == 200
158465+
- condition: $response.header.Content-Type == application/json
158466+
- context: $response.body
158467+
condition: |
158468+
{"configuration":{"values":{"key":{}}}}
158469+
type: simple
158470+
x-speakeasy-test-group: Datasources
158471+
x-speakeasy-test-rebuild: true
158472+
- workflowId: updateDatasourceInstanceConfiguration
158473+
steps:
158474+
- stepId: test
158475+
operationId: updateDatasourceInstanceConfiguration
158476+
parameters:
158477+
- name: datasourceId
158478+
in: path
158479+
value: o365sharepoint
158480+
- name: instanceId
158481+
in: path
158482+
value: o365sharepoint_abc123
158483+
requestBody:
158484+
contentType: application/json
158485+
payload:
158486+
configuration:
158487+
values: {}
158488+
successCriteria:
158489+
- condition: $statusCode == 200
158490+
- condition: $response.header.Content-Type == application/json
158491+
- context: $response.body
158492+
condition: |
158493+
{"configuration":{"values":{}}}
158494+
type: simple
158495+
x-speakeasy-test-group: Datasources
158496+
x-speakeasy-test-rebuild: true

.speakeasy/workflow.lock

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
speakeasyVersion: 1.722.7
1+
speakeasyVersion: 1.725.0
22
sources:
33
Glean API:
44
sourceNamespace: glean-api-specs
5-
sourceRevisionDigest: sha256:8b912e61e9727548c1e231c33a1cab5988630896d3c81639fe9b2961c8656d94
6-
sourceBlobDigest: sha256:079082f8fabe8221e1d14af242c72c22efa7be6626969593ccebcd74d19c3c80
5+
sourceRevisionDigest: sha256:2dbf85de9fe254142a209be3b1d49ee5e59e3d0e2b9dd8954bdc7197b9803bb5
6+
sourceBlobDigest: sha256:896f0844a61d39e29af640ade47ef06a28152bbd120cadd643b543853695a4da
77
tags:
88
- latest
9-
- speakeasy-sdk-regen-1771525162
9+
- speakeasy-sdk-regen-1771639536
1010
Glean Client API:
1111
sourceNamespace: glean-client-api
1212
sourceRevisionDigest: sha256:4edc63ad559e4f2c9fb9ebf5edaaaaa9269f1874d271cfd84b441d6dacac43d2
@@ -17,10 +17,10 @@ targets:
1717
glean:
1818
source: Glean API
1919
sourceNamespace: glean-api-specs
20-
sourceRevisionDigest: sha256:8b912e61e9727548c1e231c33a1cab5988630896d3c81639fe9b2961c8656d94
21-
sourceBlobDigest: sha256:079082f8fabe8221e1d14af242c72c22efa7be6626969593ccebcd74d19c3c80
20+
sourceRevisionDigest: sha256:2dbf85de9fe254142a209be3b1d49ee5e59e3d0e2b9dd8954bdc7197b9803bb5
21+
sourceBlobDigest: sha256:896f0844a61d39e29af640ade47ef06a28152bbd120cadd643b543853695a4da
2222
codeSamplesNamespace: glean-api-specs-python-code-samples
23-
codeSamplesRevisionDigest: sha256:07c1eebc0272335ffeb2b98c0b094c73bfefcf74858173515c00c683b16702f6
23+
codeSamplesRevisionDigest: sha256:6d90f2a18ec8e38c09e2cca697ce65cd5d1a6730c207dc72ac4f8e2240a23193
2424
workflow:
2525
workflowVersion: 1.0.0
2626
speakeasyVersion: latest

0 commit comments

Comments
 (0)