Skip to content

Commit 9f8806d

Browse files
speakeasybotspeakeasybot
committed
## Python SDK Changes:
* `glean.skills.update()`: **Added** * `glean.search.query()`: `response.warnings` **Added**
1 parent 5aaa028 commit 9f8806d

43 files changed

Lines changed: 1045 additions & 169 deletions

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: 124 additions & 54 deletions
Large diffs are not rendered by default.

‎.speakeasy/gen.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ generation:
3434
generateNewTests: true
3535
skipResponseBodyAssertions: true
3636
python:
37-
version: 0.15.4
37+
version: 0.15.5
3838
additionalDependencies:
3939
dev: {}
4040
main: {}

‎.speakeasy/glean-merged-spec.yaml‎

Lines changed: 110 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@ openapi: 3.0.0
22
info:
33
version: "0.9.0"
44
title: Glean API
5-
x-source-commit-sha: 2822daae55430107c738db822cbeeb5a6bef463b
6-
x-open-api-commit-sha: 0bdefe83a21f917592624e6f1dbaa180e89d5224
5+
x-source-commit-sha: 4f466121cbd991c2e99f41443b16fc68693c7acc
6+
x-open-api-commit-sha: 69a8f3207019d75701b0203e2a6cfcdae7fd96f9
77
description: |
88
# Introduction
99
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.
@@ -401,6 +401,63 @@ paths:
401401
security:
402402
- APIToken: []
403403
/api/skills/{skill_id}:
404+
patch:
405+
tags:
406+
- Skills
407+
summary: Update skill
408+
description: |
409+
Update mutable metadata for a skill. V1 supports enabling or disabling a skill without changing its content.
410+
operationId: platform-skills-update
411+
x-visibility: Public
412+
x-glean-experimental:
413+
id: 262e1f6b-6c2d-4d6d-943b-fc251d2fb38b
414+
introduced: "2026-07-20"
415+
parameters:
416+
- name: skill_id
417+
in: path
418+
required: true
419+
description: Glean skill ID.
420+
schema:
421+
type: string
422+
minLength: 1
423+
requestBody:
424+
required: true
425+
content:
426+
application/json:
427+
schema:
428+
$ref: "#/components/schemas/PlatformSkillUpdateRequest"
429+
x-codegen-request-body-name: request
430+
responses:
431+
"200":
432+
description: Successful response.
433+
content:
434+
application/json:
435+
schema:
436+
$ref: "#/components/schemas/PlatformSkillUpdateResponse"
437+
"400":
438+
$ref: "#/components/responses/PlatformBadRequest"
439+
"401":
440+
$ref: "#/components/responses/PlatformUnauthorized"
441+
"403":
442+
$ref: "#/components/responses/PlatformForbidden"
443+
"404":
444+
$ref: "#/components/responses/PlatformNotFound"
445+
"408":
446+
$ref: "#/components/responses/PlatformRequestTimeout"
447+
"409":
448+
$ref: "#/components/responses/PlatformConflict"
449+
"413":
450+
$ref: "#/components/responses/PlatformRequestTooLarge"
451+
"429":
452+
$ref: "#/components/responses/PlatformTooManyRequests"
453+
"500":
454+
$ref: "#/components/responses/PlatformInternalServerError"
455+
"503":
456+
$ref: "#/components/responses/PlatformServiceUnavailable"
457+
x-speakeasy-group: skills
458+
x-speakeasy-name-override: update
459+
security:
460+
- APIToken: []
404461
get:
405462
tags:
406463
- Skills
@@ -5640,6 +5697,24 @@ components:
56405697
description: >-
56415698
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.
56425699
schemas:
5700+
PlatformWarning:
5701+
type: object
5702+
additionalProperties: false
5703+
required:
5704+
- code
5705+
- message
5706+
description: Non-blocking warning attached to a successful Platform response.
5707+
properties:
5708+
code:
5709+
type: string
5710+
minLength: 1
5711+
description: |
5712+
Open snake_case warning code. Clients must tolerate unknown values; the set of codes is not a closed enum.
5713+
example: results_incomplete
5714+
message:
5715+
type: string
5716+
minLength: 1
5717+
description: Human-readable warning message.
56435718
PlatformAgentsSearchRequest:
56445719
type: object
56455720
additionalProperties: false
@@ -6205,18 +6280,6 @@ components:
62056280
is_manifest:
62066281
type: boolean
62076282
description: Whether this file is the skill manifest.
6208-
PlatformSkillValidationWarning:
6209-
type: object
6210-
required:
6211-
- code
6212-
- message
6213-
properties:
6214-
code:
6215-
type: string
6216-
description: Stable warning code.
6217-
message:
6218-
type: string
6219-
description: Human-readable warning message.
62206283
PlatformSkillValidationResponse:
62216284
type: object
62226285
required:
@@ -6236,7 +6299,7 @@ components:
62366299
type: array
62376300
description: Non-blocking validation warnings.
62386301
items:
6239-
$ref: "#/components/schemas/PlatformSkillValidationWarning"
6302+
$ref: "#/components/schemas/PlatformWarning"
62406303
request_id:
62416304
type: string
62426305
description: Platform-generated request ID for support correlation.
@@ -6251,6 +6314,31 @@ components:
62516314
request_id:
62526315
type: string
62536316
description: Platform-generated request ID for support correlation.
6317+
PlatformSkillUpdateStatus:
6318+
type: string
6319+
enum:
6320+
- ENABLED
6321+
- DISABLED
6322+
description: New status for the skill.
6323+
PlatformSkillUpdateRequest:
6324+
type: object
6325+
additionalProperties: false
6326+
required:
6327+
- status
6328+
properties:
6329+
status:
6330+
$ref: "#/components/schemas/PlatformSkillUpdateStatus"
6331+
PlatformSkillUpdateResponse:
6332+
type: object
6333+
required:
6334+
- skill
6335+
- request_id
6336+
properties:
6337+
skill:
6338+
$ref: "#/components/schemas/PlatformSkill"
6339+
request_id:
6340+
type: string
6341+
description: Platform-generated request ID for support correlation.
62546342
PlatformSkillVersion:
62556343
type: object
62566344
required:
@@ -6499,6 +6587,7 @@ components:
64996587
- has_more
65006588
- next_cursor
65016589
- request_id
6590+
- warnings
65026591
properties:
65036592
results:
65046593
type: array
@@ -6515,6 +6604,12 @@ components:
65156604
request_id:
65166605
type: string
65176606
description: Platform-generated request ID for support correlation.
6607+
warnings:
6608+
type: array
6609+
description: |
6610+
Non-blocking warnings for this response. Always present; empty means `[]`. Clients must tolerate unknown warning codes.
6611+
items:
6612+
$ref: "#/components/schemas/PlatformWarning"
65186613
ActivityEventParams:
65196614
properties:
65206615
bodyContent:

‎.speakeasy/tests.arazzo.yaml‎

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -158821,7 +158821,7 @@ workflows:
158821158821
- condition: $response.header.Content-Type == application/json
158822158822
- context: $response.body
158823158823
condition: |
158824-
{"results":[],"has_more":false,"next_cursor":"<value>","request_id":"<id>"}
158824+
{"results":[],"has_more":false,"next_cursor":"<value>","request_id":"<id>","warnings":[]}
158825158825
type: simple
158826158826
x-speakeasy-test-group: search
158827158827
x-speakeasy-test-rebuild: true
@@ -159048,3 +159048,24 @@ workflows:
159048159048
type: simple
159049159049
x-speakeasy-test-group: indexing_datasources
159050159050
x-speakeasy-test-rebuild: true
159051+
- workflowId: platform-skills-update
159052+
steps:
159053+
- stepId: test
159054+
operationId: platform-skills-update
159055+
parameters:
159056+
- name: skill_id
159057+
in: path
159058+
value: <id>
159059+
requestBody:
159060+
contentType: application/json
159061+
payload:
159062+
status: DISABLED
159063+
successCriteria:
159064+
- condition: $statusCode == 200
159065+
- condition: $response.header.Content-Type == application/json
159066+
- context: $response.body
159067+
condition: |
159068+
{"skill":{"id":"<id>","display_name":"Afton14","description":"taut netsuke duh sonata boastfully elegantly management come","latest_version":425795,"latest_minor_version":741364,"status":"DISABLED","origin":"CUSTOM","owner":{"name":"<value>"},"created_at":"2024-12-20T01:31:39.364Z","updated_at":"2025-12-04T02:59:37.124Z"},"request_id":"<id>"}
159069+
type: simple
159070+
x-speakeasy-test-group: skills
159071+
x-speakeasy-test-rebuild: true

‎.speakeasy/workflow.lock‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@ speakeasyVersion: 1.790.3
22
sources:
33
Glean API:
44
sourceNamespace: glean-api-specs
5-
sourceRevisionDigest: sha256:bb3bada7cfd1fef35eb00e096010fcd9238a6dde135ee387c782bba65dfa45fb
6-
sourceBlobDigest: sha256:5552ea5e20187c775de44c60abbd112a31cf189b9486aafe2e303b5f71e76f0b
5+
sourceRevisionDigest: sha256:9240eb9f7066b7e5aa2dc82cd35379debb336f013ec4c183e9638304287b61f6
6+
sourceBlobDigest: sha256:cf1b9df8d3f454420ec48d72fedb8322218f7a480d984983c7d5f58784358a51
77
tags:
88
- latest
99
Glean Client API:
@@ -16,10 +16,10 @@ targets:
1616
glean:
1717
source: Glean API
1818
sourceNamespace: glean-api-specs
19-
sourceRevisionDigest: sha256:bb3bada7cfd1fef35eb00e096010fcd9238a6dde135ee387c782bba65dfa45fb
20-
sourceBlobDigest: sha256:5552ea5e20187c775de44c60abbd112a31cf189b9486aafe2e303b5f71e76f0b
19+
sourceRevisionDigest: sha256:9240eb9f7066b7e5aa2dc82cd35379debb336f013ec4c183e9638304287b61f6
20+
sourceBlobDigest: sha256:cf1b9df8d3f454420ec48d72fedb8322218f7a480d984983c7d5f58784358a51
2121
codeSamplesNamespace: glean-api-specs-python-code-samples
22-
codeSamplesRevisionDigest: sha256:943570f36dd3410a28a56036049c09ace110d13bee2075f5f335acc143463cee
22+
codeSamplesRevisionDigest: sha256:c5f1d305f9367200a2385789b8e4a1a63c2d5c18be448132b51484394fbc202b
2323
workflow:
2424
workflowVersion: 1.0.0
2525
speakeasyVersion: latest

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -555,6 +555,7 @@ For more information on obtaining the appropriate token type, please contact you
555555
* [create](docs/sdks/skills/README.md#create) - Create skill
556556
* [list](docs/sdks/skills/README.md#list) - List skills
557557
* [validate](docs/sdks/skills/README.md#validate) - Validate skill bundle
558+
* [update](docs/sdks/skills/README.md#update) - Update skill
558559
* [retrieve](docs/sdks/skills/README.md#retrieve) - Retrieve skill
559560
* [retrieve_content](docs/sdks/skills/README.md#retrieve_content) - Download skill content
560561
* [create_version](docs/sdks/skills/README.md#create_version) - Create skill version

‎RELEASES.md‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -808,4 +808,14 @@ Based on:
808808
### Generated
809809
- [python v0.15.4] .
810810
### Releases
811-
- [PyPI v0.15.4] https://pypi.org/project/glean-api-client/0.15.4 - .
811+
- [PyPI v0.15.4] https://pypi.org/project/glean-api-client/0.15.4 - .
812+
813+
## 2026-07-22 23:42:29
814+
### Changes
815+
Based on:
816+
- OpenAPI Doc
817+
- Speakeasy CLI 1.790.3 (2.918.4) https://github.com/speakeasy-api/speakeasy
818+
### Generated
819+
- [python v0.15.5] .
820+
### Releases
821+
- [PyPI v0.15.5] https://pypi.org/project/glean-api-client/0.15.5 - .

‎docs/models/platformsearchresponse.md‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@
33

44
## Fields
55

6-
| Field | Type | Required | Description |
7-
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
8-
| `results` | List[[models.PlatformResult](../models/platformresult.md)] | :heavy_check_mark: | Ordered list of search results. |
9-
| `has_more` | *bool* | :heavy_check_mark: | Indicates whether additional pages of results are available. |
10-
| `next_cursor` | *Nullable[str]* | :heavy_check_mark: | Opaque token to pass as `cursor` in the next request. |
11-
| `request_id` | *str* | :heavy_check_mark: | Platform-generated request ID for support correlation. |
6+
| Field | Type | Required | Description |
7+
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
8+
| `results` | List[[models.PlatformResult](../models/platformresult.md)] | :heavy_check_mark: | Ordered list of search results. |
9+
| `has_more` | *bool* | :heavy_check_mark: | Indicates whether additional pages of results are available. |
10+
| `next_cursor` | *Nullable[str]* | :heavy_check_mark: | Opaque token to pass as `cursor` in the next request. |
11+
| `request_id` | *str* | :heavy_check_mark: | Platform-generated request ID for support correlation. |
12+
| `warnings` | List[[models.PlatformWarning](../models/platformwarning.md)] | :heavy_check_mark: | Non-blocking warnings for this response. Always present; empty means `[]`. Clients must tolerate unknown warning codes.<br/> |

‎docs/models/platformskillsupdaterequest.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# PlatformSkillsUpdateRequest
2+
3+
4+
## Fields
5+
6+
| Field | Type | Required | Description |
7+
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
8+
| `skill_id` | *str* | :heavy_check_mark: | Glean skill ID. |
9+
| `platform_skill_update_request` | [models.PlatformSkillUpdateRequest](../models/platformskillupdaterequest.md) | :heavy_check_mark: | N/A |

‎docs/models/platformskillupdaterequest.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# PlatformSkillUpdateRequest
2+
3+
4+
## Fields
5+
6+
| Field | Type | Required | Description |
7+
| -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
8+
| `status` | [models.PlatformSkillUpdateStatus](../models/platformskillupdatestatus.md) | :heavy_check_mark: | New status for the skill. |

0 commit comments

Comments
 (0)