glean-upgrade-migration

# Glean Upgrade & Migration ## Overview Glean is an enterprise search platform that indexes documents across SaaS tools via connectors and exposes Search and Indexing APIs. Migrations involve connector schema changes, search API response format updates, and document permission model upgrades. Tracking API versions is critical because Glean's Indexing API enforces document schema validation — adding required fields or changing permission structures in a new version will cause bulk indexing failures and stale search results if connectors are not updated in lockstep. ## Version Detection ```typescript const GLEAN_BASE = "https://your-domain-be.glean.com/api"; async function detectGleanApiVersion(apiToken: string): Promise<void> { // Check indexing API health and version const indexRes = await fetch(`${GLEAN_BASE}/index/v1/status`, { headers: { Authorization: `Bearer ${apiToken}`, "Content-Type": "application/json" }, }); const indexStatus = await indexRes.json(); console.log(`Indexing API version: ${indexRes.headers.get("x-glean-api-version") ?? "v1"}`); console.log(`Connector status: ${JSON.stringify(indexStatus.connectors)}`); // Check search API for deprecated query parameters const searchRes = await fetch(`${GLEAN_BASE}/client/v1/search`, { method: "POST", headers: { Authorization: `Bearer ${apiToken}`, "Content-Type": "application/json" }, body: JSON.stringify({ query: "test", pageSize: 1 }), }); const deprecationHeader = searchRes....