Version 2

Author: sonuramts

api-spec/openapiSpecv3-2_0.json

@@ -2844,8 +2844,8 @@
     },
     "/api/rest/2.0/connections/refresh-tokens/revoke": {
       "post": {
-        "operationId": "invalidateConnectionTokens",
-        "description": "\n <span class=\"since-beta-tag\">Version: 26.2.0.cl or later</span>\n\nUser should have Administrative Privilege or be the Connection Author to Invalidates the refresh tokens.\n\n## Token Invalidation Rules\n\nYou can specify different combinations of identifiers to control\nwhich refresh tokens are invalidated:\n\n- **connection_identifier only**: All user's refresh tokens will be\n  deleted except the connection author.\n- **connection_identifier + user_identifiers**: Only specified user's\n  refresh tokens will be deleted. If the author's user_identifier is\n  included, their token will also be invalidated.\n- **connection_identifier + configuration_identifiers**: Refresh\n  tokens for the specified configurations will be deleted.\n- **connection_identifier + org_identifiers**: Refresh tokens for the\n  specified orgs will be deleted. This is only applicable for published\n  connections.\n\n**Note**: The `org_identifiers` field is only applicable for published connections. Using this field with unpublished connections will result in an error: \"The 'org_identifiers' field is only applicable for published connections. Please ensure the connection is published before including this field.\"\n\nAfter tokens are invalidated, logged-in users will need to re-authenticate to access visualizations.\n\n\n\n\n#### Endpoint URL\n",
+        "operationId": "revokeRefreshTokens",
+        "description": "\n <span class=\"since-beta-tag\">Version: 26.2.0.cl or later</span>\n\nUser should have Administrative Privilege or be the Connection Author to revoke the refresh tokens.\n\n## Token Revocation Rules\n\nYou can specify different combinations of identifiers to control\nwhich refresh tokens are revoked:\n\n- **connection_identifier only**: All user's refresh tokens will be\n  revoked except the connection author.\n- **connection_identifier + user_identifiers**: Only specified user's\n  refresh tokens will be revoked. If the author's user_identifier is\n  included, their token will also be revoked.\n- **connection_identifier + configuration_identifiers**: Refresh\n  tokens for the specified configurations will be revoked.\n- **connection_identifier + org_identifiers**: Refresh tokens for the\n  specified orgs will be revoked. This is only applicable for published\n  connections.\n\n**Note**: The `org_identifiers` field is only applicable for published connections. Using this field with unpublished connections will result in an error: \"The 'org_identifiers' field is only applicable for published connections. Please ensure the connection is published before including this field.\"\n\nAfter tokens are revoked, logged-in users will need to re-authenticate to access visualizations.\n\n\n\n\n#### Endpoint URL\n",
         "tags": [
           "Connections",
           "26.2.0.cl"
@@ -2857,25 +2857,25 @@
                 "type": "object",
                 "properties": {
                   "connection_identifier": {
-                    "description": "Unique ID or name of the connection whose token needs to be deleted. All the users associated with the connection will have their tokens deleted except the author.",
+                    "description": "Unique ID or name of the connection whose refresh tokens need to be revoked. All the users associated with the connection will have their refresh tokens revoked except the author.",
                     "type": "string"
                   },
                   "configuration_identifiers": {
-                    "description": "Unique ID or name of configurations. If provided, the specified configuration's user tokens will be deleted.",
+                    "description": "Unique ID or name of configurations. If provided, the specified configuration's user refresh tokens will be revoked.",
                     "type": "array",
                     "items": {
                       "type": "string"
                     }
                   },
                   "user_identifiers": {
-                    "description": "Unique ID or name of users. If provided, only the specified user's refresh tokens will be deleted. If the author's user_identifier is included, their token will also be deleted.",
+                    "description": "Unique ID or name of users. If provided, only the specified user's refresh tokens will be revoked. If the author's user_identifier is included, their token will also be revoked.",
                     "type": "array",
                     "items": {
                       "type": "string"
                     }
                   },
                   "org_identifiers": {
-                    "description": "Unique ID or name of orgs. This is applicable only for published connections. If provided, the specified org's user tokens will be deleted. This field is only valid for published connections; using it with unpublished connections will return an error.",
+                    "description": "Unique ID or name of orgs. This is applicable only for published connections. If provided, the specified org's user refresh tokens will be revoked. This field is only valid for published connections; using it with unpublished connections will return an error.",
                     "type": "array",
                     "items": {
                       "type": "string"
@@ -2897,7 +2897,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/InvalidateConnectionTokensResponse"
+                  "$ref": "#/components/schemas/RevokeRefreshTokensResponse"
                 }
               }
             }
@@ -5366,7 +5366,7 @@
     "/api/rest/2.0/customization/email": {
       "post": {
         "operationId": "createEmailCustomization",
-        "description": "\n<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 10.10.0.cl or later</span>\n\nCreates a customization configuration for the notification email.\n\n#### Pre-requisites\n\nRequires `DEVELOPER` (**has developer privilege**) or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `DEVELOPER` (**Has developer privilege**) privilege is required.\n\n**NOTE**:This endpoint in currently in beta. Contact ThoughtSpot support to enable this on your instance.\n\n#### Usage guidelines\n\nTo create a custom configuration pass these parameters in your API request:\n\n- A JSON map of configuration attributes `template_properties`. The following example shows a sample set of customization configuration:\n\n```\n{\n  {\n      \"cta_button_bg_color\": \"#444DEA\",\n    \t\"cta_text_font_color\": \"#FFFFFF\",\n    \t\"primary_bg_color\": \"#D3DEF0\",\n      \"logo_url\": \"https://storage.pardot.com/710713/1642089901EbkRibJq/TS_fullworkmark_darkmode.png\",\n  \t  \"font_family\": \"\",\n    \t\"product_name\": \"ThoughtSpot\",\n    \t\"footer_address\": \"444 Castro St, Suite 1000 Mountain View, CA 94041\",\n\t    \"footer_phone\": \"(800) 508-7008\",\n      \"replacement_value_for_liveboard\": \"Dashboard\",\n    \t\"replacement_value_for_answer\": \"Chart\",\n    \t\"replacement_value_for_spot_iq\": \"AI Insights\",\n   \t  \"hide_footer_phone\": false,\n      \"hide_footer_address\": false,\n      \"hide_product_name\": false,\n    \t\"hide_manage_notification\": false,\n    \t\"hide_mobile_app_nudge\": false,\n    \t\"hide_privacy_policy\": false,\n    \t\"hide_ts_vocabulary_definitions\": false,\n    \t\"hide_error_message\": false,\n    \t\"hide_unsubscribe_link\": false,\n      \"hide_notification_status\": false,\n    \t\"hide_modify_alert\": false,\n    \t\"company_website_url\": \"https://your-website.com/\",\n    \t\"company_privacy_policy_url\" : \"https://link-to-privacy-policy.com/\",\n      \"contact_support_url\": \"https://link-to-contact-support.com/\",\n      \"hide_contact_support_url\": false\n  }\n}\n```\n\n\n\n\n#### Endpoint URL\n",
+        "description": "\n<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 10.10.0.cl or later</span>\n\nCreates a customization configuration for the notification email.\n\n#### Pre-requisites\n\nRequires `DEVELOPER` (**has developer privilege**) or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `DEVELOPER` (**Has developer privilege**) privilege is required.\n\n**NOTE**:This endpoint in currently in beta. Contact ThoughtSpot support to enable this on your instance.\n\n#### Usage guidelines\n\nTo create a custom configuration pass these parameters in your API request:\n\n- A JSON map of configuration attributes `template_properties`. The following example shows a sample set of customization configuration:\n\n```\n{\n  {\n    \"ctaButtonBgColor\": \"#444DEA\",\n    \"ctaTextFontColor\": \"#FFFFFF\",\n    \"primaryBgColor\": \"#D3DEF0\",\n    \"hideMobileAppNudge\": false,\n    \"fontFamily\" : \"\",\n    \"hideProductName\" : false,\n    \"hideFooterPhone\" : false,\n    \"hideFooterAddress\" : false,\n    \"hidePrivacyPolicy\" : false,\n    \"hideManageNotification\" : false,\n    \"hideTsVocabularyDefinitions\": false,\n    \"hideNotificationStatus\" : false,\n    \"hideErrorMessage\": false,\n    \"hideUnsubscribeLink\" : false,\n    \"hideModifyAlert\": false,\n    \"textTransform\": \"\",\n    \"replacementValueForLiveboard\": \"LB dashboard\",\n    \"replacementValueForAnswer\": \"Answer dashboard\",\n    \"replacementValueForSpotIQ\": \"SpotIQ dashboard\",\n    \"logoUrl\":\"\",\n    \"productName\":\"ThoughtSpot\",\n    \"footerPhone\":\"(800) 508-7008\",\n    \"footerAddress\":\"444 Castro St, Suite 1000 Mountain View, CA 94041\",\n    \"companyWebsiteUrl\":\"\",\n    \"companyPrivacyPolicyUrl\":\"\"\n  }\n}\n```\n\n\n\n\n#### Endpoint URL\n",
         "tags": [
           "Email Customization",
           "10.10.0.cl"
@@ -5653,7 +5653,7 @@
     "/api/rest/2.0/customization/email/update": {
       "post": {
         "operationId": "updateEmailCustomization",
-        "description": "\n<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 10.12.0.cl or later</span>\n\nUpdates a customization configuration for the notification email.\n\n#### Pre-requisites\n\nRequires `DEVELOPER` (**has developer privilege**) or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `DEVELOPER` (**Has developer privilege**) privilege is required.\n\n**NOTE**:This endpoint in currently in beta. Contact ThoughtSpot support to enable this on your instance.\n\n#### Usage guidelines\n\nTo update a custom configuration pass these parameters in your API request:\n\n- A JSON map of configuration attributes `template_properties`. The following example shows a sample set of customization configuration:\n\n```\n{\n  {\n      \"cta_button_bg_color\": \"#444DEA\",\n    \t\"cta_text_font_color\": \"#FFFFFF\",\n    \t\"primary_bg_color\": \"#D3DEF0\",\n      \"logo_url\": \"https://storage.pardot.com/710713/1642089901EbkRibJq/TS_fullworkmark_darkmode.png\",\n  \t  \"font_family\": \"\",\n    \t\"product_name\": \"ThoughtSpot\",\n    \t\"footer_address\": \"444 Castro St, Suite 1000 Mountain View, CA 94041\",\n\t    \"footer_phone\": \"(800) 508-7008\",\n      \"replacement_value_for_liveboard\": \"Dashboard\",\n    \t\"replacement_value_for_answer\": \"Chart\",\n    \t\"replacement_value_for_spot_iq\": \"AI Insights\",\n   \t  \"hide_footer_phone\": false,\n      \"hide_footer_address\": false,\n      \"hide_product_name\": false,\n    \t\"hide_manage_notification\": false,\n    \t\"hide_mobile_app_nudge\": false,\n    \t\"hide_privacy_policy\": false,\n    \t\"hide_ts_vocabulary_definitions\": false,\n    \t\"hide_error_message\": false,\n    \t\"hide_unsubscribe_link\": false,\n      \"hide_notification_status\": false,\n    \t\"hide_modify_alert\": false,\n    \t\"company_website_url\": \"https://your-website.com/\",\n    \t\"company_privacy_policy_url\" : \"https://link-to-privacy-policy.com/\",\n      \"contact_support_url\": \"https://link-to-contact-support.com/\",\n      \"hide_contact_support_url\": false\n  }\n}\n```\n\n\n\n\n#### Endpoint URL\n",
+        "description": "\n<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 10.12.0.cl or later</span>\n\nUpdates a customization configuration for the notification email.\n\n#### Pre-requisites\n\nRequires `DEVELOPER` (**has developer privilege**) or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `DEVELOPER` (**Has developer privilege**) privilege is required.\n\n**NOTE**:This endpoint in currently in beta. Contact ThoughtSpot support to enable this on your instance.\n\n#### Usage guidelines\n\nTo update a custom configuration pass these parameters in your API request:\n\n- A JSON map of configuration attributes `template_properties`. The following example shows a sample set of customization configuration:\n\n```\n{\n  {\n    \"ctaButtonBgColor\": \"#444DEA\",\n    \"ctaTextFontColor\": \"#FFFFFF\",\n    \"primaryBgColor\": \"#D3DEF0\",\n    \"hideMobileAppNudge\": false,\n    \"fontFamily\" : \"\",\n    \"hideProductName\" : false,\n    \"hideFooterPhone\" : false,\n    \"hideFooterAddress\" : false,\n    \"hidePrivacyPolicy\" : false,\n    \"hideManageNotification\" : false,\n    \"hideTsVocabularyDefinitions\": false,\n    \"hideNotificationStatus\" : false,\n    \"hideErrorMessage\": false,\n    \"hideUnsubscribeLink\" : false,\n    \"hideModifyAlert\": false,\n    \"textTransform\": \"\",\n    \"replacementValueForLiveboard\": \"LB dashboard\",\n    \"replacementValueForAnswer\": \"Answer dashboard\",\n    \"replacementValueForSpotIQ\": \"SpotIQ dashboard\",\n    \"logoUrl\":\"\",\n    \"productName\":\"ThoughtSpot\",\n    \"footerPhone\":\"(800) 508-7008\",\n    \"footerAddress\":\"444 Castro St, Suite 1000 Mountain View, CA 94041\",\n    \"companyWebsiteUrl\":\"\",\n    \"companyPrivacyPolicyUrl\":\"\"\n  }\n}\n```\n\n\n\n\n#### Endpoint URL\n",
         "tags": [
           "Email Customization",
           "10.12.0.cl"
@@ -22380,15 +22380,15 @@
           }
         }
       },
-      "InvalidateConnectionTokensResponse": {
+      "RevokeRefreshTokensResponse": {
         "type": "object",
         "required": [
           "revoke_result"
         ],
         "properties": {
           "revoke_result": {
             "type": "string",
-            "description": "Result message describing the outcome of the token revocation operation."
+            "description": "Result message describing the outcome of the refresh token revocation operation."
           }
         }
       },
@@ -23899,16 +23899,6 @@
             "type": "string",
             "description": "Company website URL (HTTP/HTTPS only)",
             "nullable": true
-          },
-          "contact_support_url": {
-            "type": "string",
-            "description": "Contact support url (HTTP/HTTPS only).",
-            "nullable": true
-          },
-          "hide_contact_support_url": {
-            "type": "boolean",
-            "description": "Whether to hide contact support url.",
-            "nullable": true
           }
         },
         "description": "Email customization configuration properties"