stackql · jeffreyaven · May 20, 2025 · May 20, 2025 · May 20, 2025 · May 20, 2025
diff --git a/providers/src/snowflake/v00.00.00000/provider.yaml b/providers/src/snowflake/v00.00.00000/provider.yaml
@@ -54,34 +54,6 @@ providerServices:
     version: v00.00.00000
     description: The Snowflake Compute Pools API is a REST API that you can use to
       access, update, and perform common actions on Compute Pool resources.
-  cortex_analyst:
-    id: cortex_analyst:v00.00.00000
-    name: cortex_analyst
-    preferred: true
-    service:
-      $ref: snowflake/v00.00.00000/services/cortex-analyst.yaml
-    title: Cortex Analyst API
-    version: v00.00.00000
-    description: The Snowflake Cortex Analyst API is a REST API that allows end user
-      to chat with their data leveraging semantic models to generate SQL queries.
-  cortex_inference:
-    id: cortex_inference:v00.00.00000
-    name: cortex_inference
-    preferred: true
-    service:
-      $ref: snowflake/v00.00.00000/services/cortex-inference.yaml
-    title: Cortex Inference API
-    version: v00.00.00000
-    description: OpenAPI 3.0 specification for the Cortex REST API
-  cortex_search_service:
-    id: cortex_search_service:v00.00.00000
-    name: cortex_search_service
-    preferred: true
-    service:
-      $ref: snowflake/v00.00.00000/services/cortex-search-service.yaml
-    title: Cortex Search REST API
-    version: v00.00.00000
-    description: OpenAPI 3.0 specification for the Cortex Search REST API
   database_role:
     id: database_role:v00.00.00000
     name: database_role
@@ -271,16 +243,6 @@ providerServices:
     version: v00.00.00000
     description: The Snowflake Schema API is a REST API that you can use to access,
       update, and perform certain actions on a Snowflake schema.
-  service:
-    id: service:v00.00.00000
-    name: service
-    preferred: true
-    service:
-      $ref: snowflake/v00.00.00000/services/service.yaml
-    title: Snowflake Services API
-    version: v00.00.00000
-    description: The Snowflake Services API is a REST API that you can use to access,
-      update, and perform certain actions on Services resource in a Snowflake database.
   sqlapi:
     id: sqlapi:v00.00.00000
     name: sqlapi
@@ -301,12 +263,12 @@ providerServices:
     version: v00.00.00000
     description: The Snowflake Stage API is a REST API that you can use to access,
       update, and perform certain actions on stage resources in a Snowflake database.
-  stream:
-    id: stream:v00.00.00000
-    name: stream
+  streams:
+    id: streams:v00.00.00000
+    name: streams
     preferred: true
     service:
-      $ref: snowflake/v00.00.00000/services/stream.yaml
+      $ref: snowflake/v00.00.00000/services/streams.yaml
     title: Snowflake Stream API
     version: v00.00.00000
     description: The Snowflake Stream API is a REST API that you can use to access,
@@ -374,5 +336,5 @@ providerServices:
       customize and manage virtual warehouse in a Snowflake account.
 config:
   auth:
-    credentialsenvvar: SNOWFLAKE_CREDENTIALS
-    type: service_account
+    type: bearer
+    credentialsenvvar: SNOWFLAKE_PAT
diff --git a/providers/src/snowflake/v00.00.00000/services/account.yaml b/providers/src/snowflake/v00.00.00000/services/account.yaml
@@ -1,9 +1,11 @@
 openapi: 3.0.0
 servers:
-- url: https://{organization}.snowflakecomputing.com/
+- url: https://{endpoint}.snowflakecomputing.com
+  description: Multi-tenant Snowflake endpoint
   variables:
-    organization:
-      default: org-account
+    endpoint:
+      default: orgid-acctid
+      description: Organization and Account Name
 info:
   version: 0.0.1
   title: Snowflake Account API
@@ -410,12 +412,13 @@ components:
       - admin_name
       - email
       - edition
-    description: If the identifier contains spaces or special characters, the entire
-      string must be enclosed in double quotes. Identifiers enclosed in double quotes
-      are also case-sensitive.
     Identifier:
       type: string
-      description: A Snowflake object identifier.
+      description: 'A Snowflake object identifier. If the identifier contains spaces
+        or special characters,  the entire string must be enclosed in double quotes.  Identifiers
+        enclosed in double quotes are also case-sensitive.
+
+        '
       pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$
       example: TEST_NAME
     ErrorResponse:
@@ -593,11 +596,26 @@ components:
       - $ref: '#/components/schemas/TargetLag'
   securitySchemes:
     KeyPair:
-      $ref: '#/components/securitySchemes/KeyPair'
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: Set `X-Snowflake-Authorization-Token-Type` to `KEYPAIR_JWT` if
+        the token is a key-pair authentication JWT.
     ExternalOAuth:
-      $ref: '#/components/securitySchemes/ExternalOAuth'
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: Configure External Oauth with Snowflake (see <a href=https://docs.snowflake.com/en/user-guide/oauth-ext-overview>External
+        OAuth overview</a>.) Set `X-Snowflake-Authorization-Token-Type` to `OAUTH`
+        and set the Token to the auth token received from the external Auth server.
     SnowflakeOAuth:
-      $ref: '#/components/securitySchemes/SnowflakeOAuth'
+      type: oauth2
+      flows:
+        implicit:
+          authorizationUrl: /oauth/authorize
+          scopes: {}
+      description: Set `X-Snowflake-Authorization-Token-Type` to `OAUTH` if the token
+        is snowflakeOAuth
   parameters:
     database:
       name: database
@@ -1006,10 +1024,6 @@ components:
         application/json:
           schema:
             $ref: '#/components/schemas/ErrorResponse'
-  security:
-  - KeyPair: []
-  - ExternalOAuth: []
-  - SnowflakeOAuth: []
   x-stackQL-resources:
     accounts:
       methods:
@@ -1046,6 +1060,9 @@ components:
         delete:
         - $ref: '#/components/x-stackQL-resources/accounts/methods/delete_account'
         replace: []
+      id: snowflake.account.accounts
+      name: accounts
+      title: Accounts
 security:
 - KeyPair: []
 - ExternalOAuth: []

diff --git a/providers/src/snowflake/v00.00.00000/services/alert.yaml b/providers/src/snowflake/v00.00.00000/services/alert.yaml
@@ -1,9 +1,11 @@
 openapi: 3.0.0
 servers:
-- url: https://{organization}.snowflakecomputing.com/
+- url: https://{endpoint}.snowflakecomputing.com
+  description: Multi-tenant Snowflake endpoint
   variables:
-    organization:
-      default: org-account
+    endpoint:
+      default: orgid-acctid
+      description: Organization and Account Name
 info:
   version: 0.0.1
   title: Snowflake Alert API
@@ -473,12 +475,13 @@ components:
           description: Statement of the point of time.
       required:
       - statement
-    description: If the identifier contains spaces or special characters, the entire
-      string must be enclosed in double quotes. Identifiers enclosed in double quotes
-      are also case-sensitive.
     Identifier:
       type: string
-      description: A Snowflake object identifier.
+      description: 'A Snowflake object identifier. If the identifier contains spaces
+        or special characters,  the entire string must be enclosed in double quotes.  Identifiers
+        enclosed in double quotes are also case-sensitive.
+
+        '
       pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$
       example: TEST_NAME
     ErrorResponse:
@@ -594,11 +597,26 @@ components:
       - $ref: '#/components/schemas/TargetLag'
   securitySchemes:
     KeyPair:
-      $ref: '#/components/securitySchemes/KeyPair'
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: Set `X-Snowflake-Authorization-Token-Type` to `KEYPAIR_JWT` if
+        the token is a key-pair authentication JWT.
     ExternalOAuth:
-      $ref: '#/components/securitySchemes/ExternalOAuth'
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: Configure External Oauth with Snowflake (see <a href=https://docs.snowflake.com/en/user-guide/oauth-ext-overview>External
+        OAuth overview</a>.) Set `X-Snowflake-Authorization-Token-Type` to `OAUTH`
+        and set the Token to the auth token received from the external Auth server.
     SnowflakeOAuth:
-      $ref: '#/components/securitySchemes/SnowflakeOAuth'
+      type: oauth2
+      flows:
+        implicit:
+          authorizationUrl: /oauth/authorize
+          scopes: {}
+      description: Set `X-Snowflake-Authorization-Token-Type` to `OAUTH` if the token
+        is snowflakeOAuth
   parameters:
     database:
       name: database
@@ -1007,10 +1025,6 @@ components:
         application/json:
           schema:
             $ref: '#/components/schemas/ErrorResponse'
-  security:
-  - KeyPair: []
-  - ExternalOAuth: []
-  - SnowflakeOAuth: []
   x-stackQL-resources:
     alerts:
       methods:
@@ -1060,6 +1074,9 @@ components:
         delete:
         - $ref: '#/components/x-stackQL-resources/alerts/methods/delete_alert'
         replace: []
+      id: snowflake.alert.alerts
+      name: alerts
+      title: Alerts
 security:
 - KeyPair: []
 - ExternalOAuth: []

diff --git a/providers/src/snowflake/v00.00.00000/services/api-integration.yaml b/providers/src/snowflake/v00.00.00000/services/api-integration.yaml
@@ -1,9 +1,11 @@
 openapi: 3.0.0
 servers:
-- url: https://{organization}.snowflakecomputing.com/
+- url: https://{endpoint}.snowflakecomputing.com
+  description: Multi-tenant Snowflake endpoint
   variables:
-    organization:
-      default: org-account
+    endpoint:
+      default: orgid-acctid
+      description: Organization and Account Name
 info:
   version: 0.0.1
   title: Snowflake API Integration API
@@ -384,12 +386,13 @@ components:
       description: An alphanumeric string that is used to identify API clients and
         control access to the API, also called a subscription key.
       nullable: true
-    description: If the identifier contains spaces or special characters, the entire
-      string must be enclosed in double quotes. Identifiers enclosed in double quotes
-      are also case-sensitive.
     Identifier:
       type: string
-      description: A Snowflake object identifier.
+      description: 'A Snowflake object identifier. If the identifier contains spaces
+        or special characters,  the entire string must be enclosed in double quotes.  Identifiers
+        enclosed in double quotes are also case-sensitive.
+
+        '
       pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$
       example: TEST_NAME
     ErrorResponse:
@@ -567,11 +570,26 @@ components:
       - $ref: '#/components/schemas/TargetLag'
   securitySchemes:
     KeyPair:
-      $ref: '#/components/securitySchemes/KeyPair'
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: Set `X-Snowflake-Authorization-Token-Type` to `KEYPAIR_JWT` if
+        the token is a key-pair authentication JWT.
     ExternalOAuth:
-      $ref: '#/components/securitySchemes/ExternalOAuth'
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: Configure External Oauth with Snowflake (see <a href=https://docs.snowflake.com/en/user-guide/oauth-ext-overview>External
+        OAuth overview</a>.) Set `X-Snowflake-Authorization-Token-Type` to `OAUTH`
+        and set the Token to the auth token received from the external Auth server.
     SnowflakeOAuth:
-      $ref: '#/components/securitySchemes/SnowflakeOAuth'
+      type: oauth2
+      flows:
+        implicit:
+          authorizationUrl: /oauth/authorize
+          scopes: {}
+      description: Set `X-Snowflake-Authorization-Token-Type` to `OAUTH` if the token
+        is snowflakeOAuth
   parameters:
     database:
       name: database
@@ -980,10 +998,6 @@ components:
         application/json:
           schema:
             $ref: '#/components/schemas/ErrorResponse'
-  security:
-  - KeyPair: []
-  - ExternalOAuth: []
-  - SnowflakeOAuth: []
   x-stackQL-resources:
     api_integrations:
       methods:
@@ -1028,6 +1042,9 @@ components:
         - $ref: '#/components/x-stackQL-resources/api_integrations/methods/delete_api_integration'
         replace:
         - $ref: '#/components/x-stackQL-resources/api_integrations/methods/create_or_alter_api_integration'
+      id: snowflake.api_integration.api_integrations
+      name: api_integrations
+      title: Api Integrations
 security:
 - KeyPair: []
 - ExternalOAuth: []

diff --git a/providers/src/snowflake/v00.00.00000/services/catalog-integration.yaml b/providers/src/snowflake/v00.00.00000/services/catalog-integration.yaml
@@ -1,9 +1,11 @@
 openapi: 3.0.0
 servers:
-- url: https://{organization}.snowflakecomputing.com/
+- url: https://{endpoint}.snowflakecomputing.com
+  description: Multi-tenant Snowflake endpoint
   variables:
-    organization:
-      default: org-account
+    endpoint:
+      default: orgid-acctid
+      description: Organization and Account Name
 info:
   version: 0.0.1
   title: Snowflake Catalog Integration API
@@ -346,12 +348,13 @@ components:
       - oauth_client_id
       - oauth_client_secret
       - oauth_allowed_scopes
-    description: If the identifier contains spaces or special characters, the entire
-      string must be enclosed in double quotes. Identifiers enclosed in double quotes
-      are also case-sensitive.
     Identifier:
       type: string
-      description: A Snowflake object identifier.
+      description: 'A Snowflake object identifier. If the identifier contains spaces
+        or special characters,  the entire string must be enclosed in double quotes.  Identifiers
+        enclosed in double quotes are also case-sensitive.
+
+        '
       pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$
       example: TEST_NAME
     ErrorResponse:
@@ -957,10 +960,6 @@ components:
         application/json:
           schema:
             $ref: '#/components/schemas/ErrorResponse'
-  security:
-  - KeyPair: []
-  - ExternalOAuth: []
-  - SnowflakeOAuth: []
   x-stackQL-resources:
     catalog_integrations:
       methods:
@@ -998,3 +997,6 @@ components:
         delete:
         - $ref: '#/components/x-stackQL-resources/catalog_integrations/methods/delete_catalog_integration'
         replace: []
+      id: snowflake.catalog_integration.catalog_integrations
+      name: catalog_integrations
+      title: Catalog Integrations