Skip to main content

Changelog

Keep up with the latest changes and updates to Glean's developer platform.

OAuth for Remote MCP Server (Private Beta)

You can now use the Device Authorization Flow with the same SSO provider configured in Glean to authenticate users connecting their clients to Glean’s remote MCP server.

See here for setup instructions

Note: OAuth is also enabled for the local MCP server.

Go API Client v0.6.0

Breaking Changes: Updated minimum go version to 1.22 (from 1.20).

Updates to API Reference Code Snippets

Update the generated code snippets that are displayed throughout the Client
API Reference and Indexing API
Reference docs to include the
required instance parameter in the API client constructor.

Python API Client v0.6.0 - Breaking Changes

The Python API client now uses a namespaced package structure. All imports must be updated from glean to glean.api_client.

Read more

What Changed

  • Import paths have changed from from glean import ... to from glean.api_client import ...
  • This affects all classes including Glean, models, and other API components

Migration Required

Before:

from glean import Glean
from glean import models
from glean.models import Something
from glean.exceptions import ApiError

After:

from glean.api_client import Glean
from glean.api_client import models
from glean.api_client.models import Something
from glean.api_client.exceptions import ApiError

Automated Migration

Use ast-grep (a structural search and replace tool) to automatically update your Python code:

# First, update imports from glean submodules (e.g., from glean.models import ...)
ast-grep --update-all \
  --pattern 'from glean.$SUBMODULE import $$REST' \
  --rewrite 'from glean.api_client.$SUBMODULE import $$REST' \
  --lang python \
  path/to/your/code

# Then, update basic glean imports (e.g., from glean import ...)
ast-grep --update-all \
  --pattern 'from glean import $$REST' \
  --rewrite 'from glean.api_client import $$REST' \
  --lang python \
  path/to/your/code

# Finally, fix any double-nesting that may have occurred
ast-grep --update-all \
  --pattern 'from glean.api_client.api_client import $$REST' \
  --rewrite 'from glean.api_client import $$REST' \
  --lang python \
  path/to/your/code

Manual Steps

If you prefer to update manually, search for all instances of:

  • from glean import → from glean.api_client import
  • from glean. (but not glean.api_client) → from glean.api_client.

Compatibility

  • This change affects all Python API client users
  • No functional changes to the API itself - only import paths
  • Ensure you're using the latest version of the Python API client package

Run agent API bug fix in client libraries

We fixed a bug that caused Run Agent Wait for Output
(/agents/run/wait) to return empty responses when used with the API Client
libraries.

Read more

We also fixed a bug that produced non-SSE compliant output when
using the Run Agent Stream Output
(/agents/run/stream) endpoint.

Remote MCP Server (private beta)

With Glean’s remote MCP server,
you can access Glean from MCP clients like Claude Desktop, Cursor, or Goose.
Your Glean admin can enable a remote MCP server to expose Glean agents and
tools. To join the MCP Server private beta, contact your Glean account team.

New Features for Tools and Agents API, API Clients, MCP

  • New Features:
    • Client REST API
    • New endpoint: GET /tools/list
    • New endpoint: POST /tools/call
    • API Clients - Added support for the new GET /tools/list and POST /tools/call endpoints
    • MCP Server - Support for configuring MCP server with VS Code
Read more

  • New Features:

    • Client REST API
    • New endpoint: GET /tools/list
    • New endpoint: POST /tools/call
    • API Clients - Added support for the new GET /tools/list and POST /tools/call endpoints
    • MCP Server - Support for configuring MCP server with VS Code

  • Bug Fixes:

    • Update the OpenAPI Spec to properly mark the request body as a required field. This change more
      accurately reflects how the API handles the case when the request body is not
      provided. This affects the following API endpoints: - /rest/api/v1/search - /rest/api/v1/recommendations - rest/api/v1/adminsearch

  • Breaking Changes: - Python API client: the request body OpenAPI spec change resulted in a
    breaking change due to language semantics. This aligns search method
    parameters with other methods in the API.

New Governance and Agent API Features

  • New Features:
    • Governance Admin API surface (10 endpoints)
    • Policies: retrieve, update, list, create, download - Reports:
      createReport, downloadReport, status
    • Visibility Overrides: listVisibilityOverrides,
      createVisibilityOverride
    • Agent API brought up to the LangChain Agent-Protocol (Agents & Runs stages)
    • Retrieve an Agent GET /agents/ {agent_id}
Read more

  • New Features:

    • Governance Admin API surface (10 endpoints)
    • Policies: retrieve, update, list, create, download - Reports:
      createReport, downloadReport, status
    • Visibility Overrides: listVisibilityOverrides,
      createVisibilityOverride
    • Agent API brought up to the LangChain Agent-Protocol (Agents & Runs stages)
    • Retrieve an Agent GET /agents/ {agent_id}

  • Retrieve an Agent's Schemas GET /agents/{agent_id}/schemas

    • List Agents POST /agents/search
    • Run an Agent POST /agents/runs/wait
    • Run an Agent with streaming POST /agents/runs/stream

  • Changes & Enhancements:

    • Replaced legacy alpha Run-Workflow endpoints with the standard Agent-Protocol equivalents (see above).

  • Breaking Changes:

    • Governance endpoints introduce new permission scopes (governance.read,
      governance.write).

  • Bug Fixes:

    • Python API client: resolved "unclosed async coroutine" warning in async transport.
    • Language-Specific Notes:
      • Python 0.4.1 uploaded to PyPI, requires 3.8+.
      • TypeScript 0.4.1 published, ESM, bundled types.
      • Go module path github.com/gleaninc/glean-sdk-go/v4.1.0.
      • Java 0.4.1 available on Maven Central (com.glean:glean-sdk:0.4.1).

Official API Clients Release

  • Released official API clients for Glean in multiple languages, replacing the
    previous OpenAPI Generator-based SDK approach
Read more

  • Released official API clients for Glean in multiple languages, replacing the
    previous OpenAPI Generator-based SDK approach

  • New API clients are now
    available for:

  • Updated documentation with new installation instructions and usage examples

  • Visit the API Clients page for more information

New Indexing API Endpoints for Documents and Troubleshooting

Deprecate Previous Way of Processing Response Message Stream

In the /chat API, the previous way of processing the response message stream has been deprecated as a result of the launch of LLM-generated citations.

Read more
  • LLM citations are interleaved within the response text fragments. Each fragment can have "text" or "citation".
  • If streaming is set to False, the response may still be broken up into across multiple fragments.
  • The citations interleaved inside the response do not have reference ranges (start and end indices) or snippets as they used to.
  • For backwards compatibility, we still return a chat message with citations at the end in the old format, except there will be no startIndex and no snippets.

Visit the Simple Chatbot Guide for more information and an example.

Deprecate x-scio-actas Header in Favor of x-glean-actas

  • Deprecate X-Scio-ActAs in favor of X-Glean-AtAs. X-Scio-ActAs continues to
    work, but it is an error to specify both headers.

Debug Endpoints Permission Status

  • /debug/{datasource}/document - New response field permissionIdentityStatus under status: Provides information regarding upload status of users and groups specified in document permissions
Read more

  • /debug/{datasource}/document - New response field permissionIdentityStatus under status: Provides information regarding upload status of users and groups specified in document permissions

  • /debug/{datasource}/documents - New response field permissionIdentityStatus under status: Provides information regarding upload status of users and groups specified in document permissions

Update Developer Site

The developer site has been updated with a new look, content, and features. Some new features include:

Read more
  • This documentation site is now open sourced on GitHub
  • This changelog page, which gives you a single place to see updates across the platform.
  • Ability to switch between light and dark mode.
  • A new API Clients page with documentation for all available API Clients.
  • A list of community projects and resources to help you get started with Glean.
  • Each API has its own documentation page with detailed information.

And much more...

Add MCP

Added a Model Context Protocol (MCP) server implementation for Glean's search and chat capabilities on GitHub.

This server provides a standardized interface for AI models to interact with Glean's content search and conversational AI features through stdio communication.

Visit the Agents for more information.

LangChain SDK Release

Added LangChain SDK for Python on GitHub. This SDK provides a simple interface for interacting with Glean's search and chat capabilities when using LangChain.

Visit the Agents for more information.

Update Permissions Endpoint

/updatepermissions

  • Beta launch of new endpoint to update document permissions -
    /debug/[datasource]/documents
  • Beta launch of new troubleshooting endpoint for batch queries