From 8fa38a4db940e6dfc8d3a74fa256bd5ac31c49cc Mon Sep 17 00:00:00 2001
From: Travis Hoover <travis.hoover@glean.com>
Date: Thu, 2 Jul 2026 14:42:55 -0700
Subject: [PATCH] Namespace admin APIs under x-speakeasy-group: admin

Move governance and datasource admin endpoints out of the client.*
namespace and into a dedicated admin.* namespace so they are accessed
as glean.admin.governance.*, glean.admin.datasources.*, etc.

- governance data policies/reports/findings + document visibility overrides
  now live under admin.governance.*
- datasource config/credential endpoints now grouped under admin.datasources
---
 overlays/admin-modifications-overlay.yaml | 54 ++++++++++++++++++-----
 1 file changed, 44 insertions(+), 10 deletions(-)

diff --git a/overlays/admin-modifications-overlay.yaml b/overlays/admin-modifications-overlay.yaml
index b11e36f7..f7e91ab6 100644
--- a/overlays/admin-modifications-overlay.yaml
+++ b/overlays/admin-modifications-overlay.yaml
@@ -8,41 +8,75 @@ actions:
   # Governance Admin endpoints
   - target: $["paths"]["/rest/api/v1/governance/data/policies/{id}"]["get"]
     update:
-      x-speakeasy-group: client.governance.data.policies
+      x-speakeasy-group: admin.governance.data.policies
       x-speakeasy-name-override: retrieve
   - target: $["paths"]["/rest/api/v1/governance/data/policies/{id}"]["post"]
     update:
-      x-speakeasy-group: client.governance.data.policies
+      x-speakeasy-group: admin.governance.data.policies
       x-speakeasy-name-override: update
   - target: $["paths"]["/rest/api/v1/governance/data/policies"]["get"]
     update:
-      x-speakeasy-group: client.governance.data.policies
+      x-speakeasy-group: admin.governance.data.policies
       x-speakeasy-name-override: list
   - target: $["paths"]["/rest/api/v1/governance/data/policies"]["post"]
     update:
-      x-speakeasy-group: client.governance.data.policies
+      x-speakeasy-group: admin.governance.data.policies
       x-speakeasy-name-override: create
   - target: $["paths"]["/rest/api/v1/governance/data/policies/{id}/download"]["get"]
     update:
-      x-speakeasy-group: client.governance.data.policies
+      x-speakeasy-group: admin.governance.data.policies
       x-speakeasy-name-override: download
   - target: $["paths"]["/rest/api/v1/governance/data/reports"]["post"]
     update:
-      x-speakeasy-group: client.governance.data.reports
+      x-speakeasy-group: admin.governance.data.reports
       x-speakeasy-name-override: create
   - target: $["paths"]["/rest/api/v1/governance/data/reports/{id}/download"]["get"]
     update:
-      x-speakeasy-group: client.governance.data.reports
+      x-speakeasy-group: admin.governance.data.reports
       x-speakeasy-name-override: download
   - target: $["paths"]["/rest/api/v1/governance/data/reports/{id}/status"]["get"]
     update:
-      x-speakeasy-group: client.governance.data.reports
+      x-speakeasy-group: admin.governance.data.reports
       x-speakeasy-name-override: status
   - target: $["paths"]["/rest/api/v1/governance/documents/visibilityoverrides"]["get"]
     update:
-      x-speakeasy-group: client.governance.documents.visibilityoverrides
+      x-speakeasy-group: admin.governance.documents.visibilityoverrides
       x-speakeasy-name-override: list
   - target: $["paths"]["/rest/api/v1/governance/documents/visibilityoverrides"]["post"]
     update:
-      x-speakeasy-group: client.governance.documents.visibilityoverrides
+      x-speakeasy-group: admin.governance.documents.visibilityoverrides
       x-speakeasy-name-override: create
+  # Governance findings exports
+  - target: $["paths"]["/rest/api/v1/governance/data/findings/exports"]["post"]
+    update:
+      x-speakeasy-group: admin.governance.data.findings.exports
+      x-speakeasy-name-override: create
+  - target: $["paths"]["/rest/api/v1/governance/data/findings/exports"]["get"]
+    update:
+      x-speakeasy-group: admin.governance.data.findings.exports
+      x-speakeasy-name-override: list
+  - target: $["paths"]["/rest/api/v1/governance/data/findings/exports/{id}"]["get"]
+    update:
+      x-speakeasy-group: admin.governance.data.findings.exports
+      x-speakeasy-name-override: download
+  - target: $["paths"]["/rest/api/v1/governance/data/findings/exports/{id}"]["delete"]
+    update:
+      x-speakeasy-group: admin.governance.data.findings.exports
+      x-speakeasy-name-override: delete
+  # Datasource configuration and credentials
+  - target: $["paths"]["/rest/api/v1/configure/datasources/{datasourceId}/instances/{instanceId}"]["get"]
+    update:
+      x-speakeasy-group: admin.datasources
+      x-speakeasy-name-override: getConfiguration
+  - target: $["paths"]["/rest/api/v1/configure/datasources/{datasourceId}/instances/{instanceId}"]["patch"]
+    update:
+      x-speakeasy-group: admin.datasources
+      x-speakeasy-name-override: updateConfiguration
+  - target: $["paths"]["/rest/api/v1/datasource/{datasourceInstanceId}/credentialstatus"]["get"]
+    update:
+      x-speakeasy-group: admin.datasources
+      x-speakeasy-name-override: getCredentialStatus
+  - target: $["paths"]["/rest/api/v1/datasource/{datasourceInstanceId}/credentials"]["post"]
+    update:
+      x-speakeasy-group: admin.datasources
+      x-speakeasy-name-override: rotateCredentials