Skip to content

Commit ea2af69

Browse files
committed
## Java SDK Changes:
* `glean.client.messages.retrieve()`: `response.searchResponse.gleanDataError.unauthorizedDatasourceInstances` **Removed** (Breaking ⚠️) * `glean.client.search.query()`: * `response.gleanDataError.unauthorizedDatasourceInstances` **Removed** (Breaking ⚠️) * `error.unauthorizedDatasourceInstances` **Removed** (Breaking ⚠️) * `glean.client.chat.create()`: * `request.chatRequest.messages[].fragments[].action.metadata.auth.resource` **Added** * `response` **Changed** (Breaking ⚠️) * `glean.client.search.recommendations()`: `response.gleanDataError.unauthorizedDatasourceInstances` **Removed** (Breaking ⚠️) * `glean.client.search.autocomplete()`: `response.gleanDataError.unauthorizedDatasourceInstances` **Removed** (Breaking ⚠️) * `glean.client.search.queryAsAdmin()`: * `response.gleanDataError.unauthorizedDatasourceInstances` **Removed** (Breaking ⚠️) * `error.unauthorizedDatasourceInstances` **Removed** (Breaking ⚠️) * `glean.client.chat.retrieve()`: `response.chatResult.chat.messages[].fragments[].action.metadata.auth.resource` **Added** * `glean.client.agents.list()`: `error` **Changed** * `glean.client.agents.runStream()`: `error` **Changed** * `glean.client.agents.retrieveSchemas()`: * `response.tools[]` **Changed** * `error` **Changed** * `glean.client.agents.retrieve()`: `error.status[404]` **Added** * `glean.client.chat.createStream()`: * `request.chatRequest.messages[].fragments[].action.metadata.auth.resource` **Added** * `glean.datasources.getDatasourceInstanceConfiguration()`: **Added** * `glean.datasources.updateDatasourceInstanceConfiguration()`: **Added** * `glean.indexing.people.bulkIndex()`: **Deprecated**
1 parent 3e6a5b0 commit ea2af69

167 files changed

Lines changed: 16766 additions & 3170 deletions

File tree

Some content is hidden

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

.speakeasy/gen.lock

Lines changed: 425 additions & 279 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
@@ -14,6 +14,7 @@ generation:
1414
securityFeb2025: true
1515
sharedErrorComponentsApr2025: false
1616
sharedNestedComponentsJan2026: false
17+
nameOverrideFeb2026: false
1718
auth:
1819
oAuth2ClientCredentialsEnabled: true
1920
oAuth2PasswordEnabled: true
@@ -28,7 +29,7 @@ generation:
2829
generateNewTests: false
2930
skipResponseBodyAssertions: false
3031
java:
31-
version: 0.12.23
32+
version: 0.12.24
3233
additionalDependencies: []
3334
additionalPlugins: []
3435
artifactID: glean-api-client

.speakeasy/glean-merged-spec.yaml

Lines changed: 205 additions & 17 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: b9ea91029b2b66b64b5145cea87d0bbfc2dd6a6e
5+
x-source-commit-sha: f7ce14e1b1226b07bef209b2c38c001674b0cd54
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: ef44a085147b249f40ce92e135abb4c6e5439d7d
25+
x-open-api-commit-sha: a12f969d5e64fafa493d5449ca22dc90e5bc545e
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:
@@ -7610,6 +7718,10 @@ components:
76107718
type: string
76117719
format: url
76127720
description: The OAuth provider's endpoint, where access tokens are requested.
7721+
resource:
7722+
type: string
7723+
format: url
7724+
description: The OAuth 2.0 Resource Indicator (RFC 8707) for the protected resource. Discovered from Protected Resource Metadata (RFC 9728) during DCR. Included in authorization and token exchange requests when present.
76137725
lastAuthorizedAt:
76147726
type: string
76157727
format: date-time
@@ -7944,12 +8056,6 @@ components:
79448056
chatSessionTrackingToken:
79458057
type: string
79468058
description: A token that is used to track the session.
7947-
unauthorizedDatasourceInstances:
7948-
type: array
7949-
description: |
7950-
Datasource instances that could not be queried because the user has not completed or has expired per-user OAuth, aggregated across all tools invoked in this turn.
7951-
items:
7952-
$ref: "#/components/schemas/UnauthorizedDatasourceInstance"
79538059
DeleteChatsRequest:
79548060
required:
79558061
- ids
@@ -8107,9 +8213,12 @@ components:
81078213
description: Whether the agent supports streaming output. If true, you you can stream agent ouput. All agents currently support streaming.
81088214
additionalProperties: true
81098215
ErrorResponse:
8110-
type: string
8111-
title: ErrorResponse
8112-
description: Error message returned from the server
8216+
type: object
8217+
description: Error response returned for failed requests
8218+
properties:
8219+
message:
8220+
type: string
8221+
description: Client-facing error message describing what went wrong
81138222
ActionSummary:
81148223
type: object
81158224
description: Represents a minimal summary of an action.
@@ -8123,6 +8232,32 @@ components:
81238232
display_name:
81248233
type: string
81258234
description: The display name of the action.
8235+
type:
8236+
type: string
8237+
description: The type of tool - RETRIEVAL for read-only operations, ACTION for operations that modify data.
8238+
auth_type:
8239+
type: string
8240+
description: The authentication type required - OAUTH_USER, OAUTH_ADMIN, API_KEY, BASIC_AUTH, DWD (domain-wide delegation), or NONE.
8241+
write_action_type:
8242+
type: string
8243+
description: For write actions only - REDIRECT (client renders URL) or EXECUTION (external server call).
8244+
is_setup_finished:
8245+
type: boolean
8246+
description: Whether this action has been fully configured and validated.
8247+
x-includeEmpty: true
8248+
data_source:
8249+
type: string
8250+
description: |
8251+
Indicates the kind of knowledge a tool would access or modify.
8252+
Company knowledge:
8253+
- Glean search, and any native tools that derive from it (e.g., expert search, code search)
8254+
- Native federated tools to company data sources (e.g., outlook search)
8255+
World knowledge:
8256+
- Native tools that bring in public content (e.g., web browser)
8257+
- Platform action like bingwebsearch, geminiwebsearch, etc
8258+
Neutral knowledge:
8259+
- Native tools that don't access or modify content via APIs (e.g., file analyst, think)
8260+
- Platform read or write tools (creator has to determine their knowledge implications)
81268261
AgentSchemas:
81278262
properties:
81288263
agent_id:
@@ -9026,12 +9161,6 @@ components:
90269161
federatedSearchRateLimitError:
90279162
type: boolean
90289163
description: Indicates the federated search results could not be fetched due to rate limiting.
9029-
unauthorizedDatasourceInstances:
9030-
type: array
9031-
description: |
9032-
Datasource instances that could not be queried because the user has not completed or has expired per-user OAuth.
9033-
items:
9034-
$ref: "#/components/schemas/UnauthorizedDatasourceInstance"
90359164
x-speakeasy-name-override: GleanDataError
90369165
ResultsResponse:
90379166
properties:
@@ -13217,6 +13346,49 @@ components:
1321713346
items:
1321813347
type: string
1321913348
description: List of field names to exclude from the export
13349+
ConfigurationValue:
13350+
type: object
13351+
properties:
13352+
value:
13353+
type: string
13354+
description: The configuration value as a string. Only one of value or valueList should be populated.
13355+
valueList:
13356+
type: array
13357+
items:
13358+
type: string
13359+
description: The configuration value as a list of strings. Only one of value or valueList should be populated.
13360+
description: A single configuration value, either a scalar or a list
13361+
ConfigurationValues:
13362+
type: object
13363+
additionalProperties:
13364+
$ref: '#/components/schemas/ConfigurationValue'
13365+
description: A map from configuration key names to their values
13366+
DatasourceInstanceConfiguration:
13367+
type: object
13368+
properties:
13369+
values:
13370+
$ref: '#/components/schemas/ConfigurationValues'
13371+
required:
13372+
- values
13373+
description: Configuration for a datasource instance
13374+
DatasourceConfigurationResponse:
13375+
type: object
13376+
properties:
13377+
configuration:
13378+
$ref: '#/components/schemas/DatasourceInstanceConfiguration'
13379+
required:
13380+
- configuration
13381+
description: |
13382+
The greenlisted configuration values for a datasource instance. Only keys that are exposed via the public API greenlist are included.
13383+
UpdateDatasourceConfigurationRequest:
13384+
type: object
13385+
properties:
13386+
configuration:
13387+
$ref: '#/components/schemas/DatasourceInstanceConfiguration'
13388+
required:
13389+
- configuration
13390+
description: |
13391+
Request to update greenlisted configuration values for a datasource instance. Only keys that are exposed via the public API greenlist may be set.
1322013392
ChatRequestStream:
1322113393
required:
1322213394
- messages
@@ -13274,6 +13446,22 @@ components:
1327413446
description: The offset of the client's timezone in minutes from UTC. e.g. PDT is -420 because it's 7 hours behind UTC.
1327513447
schema:
1327613448
type: integer
13449+
datasourceId:
13450+
name: datasourceId
13451+
in: path
13452+
description: The datasource type identifier (e.g. o365sharepoint)
13453+
required: true
13454+
schema:
13455+
type: string
13456+
example: o365sharepoint
13457+
instanceId:
13458+
name: instanceId
13459+
in: path
13460+
description: The datasource instance identifier
13461+
required: true
13462+
schema:
13463+
type: string
13464+
example: o365sharepoint_abc123
1327713465
responses:
1327813466
SuccessResponse:
1327913467
description: OK

.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.730.1
22
sources:
33
Glean API:
44
sourceNamespace: glean-api-specs
5-
sourceRevisionDigest: sha256:d5821c86abba62ae5c86977e91a4226c5f3c60081aca52768fb6924cc1f4e721
6-
sourceBlobDigest: sha256:25bbf44aeb95dac432ddbae594ee0954e8df205a2b24bac7855b1f3e56624d83
5+
sourceRevisionDigest: sha256:583630be5afeb06f1d1952afe4820b396b18751ca14de177cbd2982e7dcdf51c
6+
sourceBlobDigest: sha256:96eb985853d2728f3738531fda1530ed15d6bd4fe00e7832563fcd9d6bee68c5
77
tags:
88
- latest
9-
- speakeasy-sdk-regen-1771525186
9+
- speakeasy-sdk-regen-1771641359
1010
Glean-OAS:
1111
sourceNamespace: glean-oas
1212
sourceRevisionDigest: sha256:8841834dd58ddd4e2dcf98fc90fbd06fbf3626a29df941503cce55b9548a5317
@@ -18,10 +18,10 @@ targets:
1818
glean:
1919
source: Glean API
2020
sourceNamespace: glean-api-specs
21-
sourceRevisionDigest: sha256:d5821c86abba62ae5c86977e91a4226c5f3c60081aca52768fb6924cc1f4e721
22-
sourceBlobDigest: sha256:25bbf44aeb95dac432ddbae594ee0954e8df205a2b24bac7855b1f3e56624d83
21+
sourceRevisionDigest: sha256:583630be5afeb06f1d1952afe4820b396b18751ca14de177cbd2982e7dcdf51c
22+
sourceBlobDigest: sha256:96eb985853d2728f3738531fda1530ed15d6bd4fe00e7832563fcd9d6bee68c5
2323
codeSamplesNamespace: glean-api-specs-java-code-samples
24-
codeSamplesRevisionDigest: sha256:20200550df64700f76dee5b1c099271d649b72a7a845352b2162c87dd708b0a2
24+
codeSamplesRevisionDigest: sha256:35128dbabd836dbe5af7a40941ec25e3c0ee2199708237a0e3391bca81b1719a
2525
workflow:
2626
workflowVersion: 1.0.0
2727
speakeasyVersion: latest

0 commit comments

Comments
 (0)