Skip to content

Un-namespace platform SDK groups (glean.agents.search()) #119

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
travis-hoover-glean wants to merge 1 commit into from
Closed

Un-namespace platform SDK groups (glean.agents.search()) #119

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
254 changes: 18 additions & 236 deletions generated_specs/platform.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ openapi: 3.0.0
info:
version: "2026-04-01"
title: Glean Platform API
x-source-commit-sha: 44c1747d2fec67e1181e76564b99784cd52b01e3
x-source-commit-sha: cf583b0e762aa34ecfba8c88590d6f47342749bd
x-open-api-commit-sha: 555c01b4c1a23b5ffb6678cc56350eb2e1dac052
servers:
- url: https://{instance}-be.glean.com
Expand Down Expand Up @@ -55,7 +55,7 @@ paths:
$ref: "#/components/responses/PlatformInternalServerError"
"503":
$ref: "#/components/responses/PlatformServiceUnavailable"
x-speakeasy-group: platform.agents
x-speakeasy-group: agents
x-speakeasy-name-override: search
/api/agents/{agent_id}:
get:
Expand Down Expand Up @@ -100,7 +100,7 @@ paths:
$ref: "#/components/responses/PlatformInternalServerError"
"503":
$ref: "#/components/responses/PlatformServiceUnavailable"
x-speakeasy-group: platform.agents
x-speakeasy-group: agents
x-speakeasy-name-override: get
/api/agents/{agent_id}/schemas:
get:
Expand Down Expand Up @@ -152,7 +152,7 @@ paths:
$ref: "#/components/responses/PlatformInternalServerError"
"503":
$ref: "#/components/responses/PlatformServiceUnavailable"
x-speakeasy-group: platform.agents
x-speakeasy-group: agents
x-speakeasy-name-override: getSchemas
/api/agents/{agent_id}/runs:
post:
Expand Down Expand Up @@ -218,106 +218,8 @@ paths:
$ref: "#/components/responses/PlatformInternalServerError"
"503":
$ref: "#/components/responses/PlatformServiceUnavailable"
x-speakeasy-group: platform.agents
x-speakeasy-group: agents
x-speakeasy-name-override: createRun
/api/skills:
get:
tags:
- Skills
summary: List skills
description: |
List skills available to the authenticated user.
operationId: platform-skills-list
x-visibility: Public
x-glean-experimental:
id: 3eb65937-03a3-472b-9a00-be713f302b5f
introduced: "2026-06-23"
parameters:
- in: query
name: page_size
description: Maximum number of skills to return.
required: false
schema:
type: integer
minimum: 1
maximum: 100
- in: query
name: cursor
description: Opaque pagination cursor from a previous response.
required: false
schema:
type: string
minLength: 1
responses:
"200":
description: Successful response.
content:
application/json:
schema:
$ref: "#/components/schemas/PlatformSkillsListResponse"
"400":
$ref: "#/components/responses/PlatformBadRequest"
"401":
$ref: "#/components/responses/PlatformUnauthorized"
"403":
$ref: "#/components/responses/PlatformForbidden"
"404":
$ref: "#/components/responses/PlatformNotFound"
"408":
$ref: "#/components/responses/PlatformRequestTimeout"
"429":
$ref: "#/components/responses/PlatformTooManyRequests"
"500":
$ref: "#/components/responses/PlatformInternalServerError"
"503":
$ref: "#/components/responses/PlatformServiceUnavailable"
x-speakeasy-group: platform.skills
x-speakeasy-name-override: list
/api/skills/{skill_id}:
get:
tags:
- Skills
summary: Retrieve skill
description: |
Retrieve metadata for a skill available to the authenticated user.
operationId: platform-skills-get
x-visibility: Public
x-glean-experimental:
id: 8f8d1c92-a484-4769-9903-200613dc8a72
introduced: "2026-06-23"
parameters:
- name: skill_id
in: path
required: true
description: Glean skill ID.
schema:
type: string
minLength: 1
responses:
"200":
description: Successful response.
content:
application/json:
schema:
$ref: "#/components/schemas/PlatformSkillGetResponse"
"400":
$ref: "#/components/responses/PlatformBadRequest"
"401":
$ref: "#/components/responses/PlatformUnauthorized"
"403":
$ref: "#/components/responses/PlatformForbidden"
"404":
$ref: "#/components/responses/PlatformNotFound"
"408":
$ref: "#/components/responses/PlatformRequestTimeout"
"429":
$ref: "#/components/responses/PlatformTooManyRequests"
"500":
$ref: "#/components/responses/PlatformInternalServerError"
"503":
$ref: "#/components/responses/PlatformServiceUnavailable"
x-speakeasy-group: platform.skills
x-speakeasy-name-override: retrieve
/api/search:
post:
tags:
Expand Down Expand Up @@ -360,7 +262,7 @@ paths:
$ref: "#/components/responses/PlatformInternalServerError"
"503":
$ref: "#/components/responses/PlatformServiceUnavailable"
x-speakeasy-group: platform.search
x-speakeasy-group: search
x-speakeasy-name-override: query
components:
securitySchemes:
Expand Down Expand Up @@ -692,138 +594,6 @@ components:
request_id:
type: string
description: Platform-generated request ID for support correlation.
PlatformSkillStatus:
type: string
enum:
- DRAFT
- ENABLED
- DISABLED
description: Current skill status.
PlatformSkillOrigin:
type: string
enum:
- CUSTOM
description: Source category for the skill.
PlatformSkillSyncStatus:
type: string
enum:
- UP_TO_DATE
- UPDATE_AVAILABLE
- SYNC_FAILED
description: Current external-source sync status.
PlatformSkillSourceProvenance:
type: object
properties:
source_url:
type: string
description: URL of the external source the skill was imported from.
commit_sha:
type: string
description: Source commit SHA for the imported skill.
imported_at:
type: string
format: date-time
description: Time the skill was imported.
last_synced_at:
type: string
format: date-time
description: Time the skill was last synced from its source.
sync_status:
$ref: "#/components/schemas/PlatformSkillSyncStatus"
sync_error:
type: string
description: Human-readable sync failure reason, present only when sync_status is SYNC_FAILED.
PlatformPersonReference:
type: object
description: A lightweight reference to a person, used where a payload merely points at someone.
required:
- name
properties:
id:
type: string
description: Opaque Glean person ID.
name:
type: string
description: Display name.
PlatformSkill:
type: object
required:
- id
- display_name
- description
- latest_version
- latest_minor_version
- status
- origin
- owner
- created_at
- updated_at
properties:
id:
type: string
description: Glean skill ID.
display_name:
type: string
description: Human-readable skill name.
description:
type: string
description: Human-readable skill description.
latest_version:
type: integer
description: Latest major version number for the skill.
latest_minor_version:
type: integer
description: Latest minor version number for the skill.
status:
$ref: "#/components/schemas/PlatformSkillStatus"
origin:
$ref: "#/components/schemas/PlatformSkillOrigin"
source_provenance:
$ref: "#/components/schemas/PlatformSkillSourceProvenance"
owner:
$ref: "#/components/schemas/PlatformPersonReference"
created_at:
type: string
format: date-time
description: Time the skill was created.
updated_at:
type: string
format: date-time
description: Time the skill was last updated.
PlatformSkillsListResponse:
type: object
required:
- skills
- has_more
- next_cursor
- request_id
properties:
skills:
type: array
description: Skills available to the user.
items:
$ref: "#/components/schemas/PlatformSkill"
has_more:
type: boolean
description: Whether additional results are available.
next_cursor:
type: string
nullable: true
description: Cursor for the next page, or null when no more results are available.
request_id:
type: string
description: Platform-generated request ID for support correlation.
PlatformSkillGetResponse:
type: object
required:
- skill
- request_id
properties:
skill:
$ref: "#/components/schemas/PlatformSkill"
request_id:
type: string
description: Platform-generated request ID for support correlation.
PlatformFilterOperator:
type: string
description: Supported filter operator.
Expand Down Expand Up @@ -921,6 +691,18 @@ components:
Structured filters applied to search results. Equality operators OR multiple values within a filter. Multiple filters are AND'd together, including range filters on the same field. Filters are AND'd with any inline operators in `query`. Note that conflicting constraints on the same field (e.g., `type:document` in the query and `type: spreadsheet` in a filter) produce an empty result set.
time_range:
$ref: "#/components/schemas/PlatformTimeRange"
PlatformPersonReference:
type: object
description: A lightweight reference to a person, used where a payload merely points at someone.
required:
- name
properties:
id:
type: string
description: Opaque Glean person ID.
name:
type: string
description: Display name.
PlatformResult:
type: object
required:
Expand Down
Loading
Loading