{ "info": { "_postman_id": "5c2cff8a-7b4a-445f-ad88-4f80d7f82aa8", "name": "ThoughtSpot Public REST 10.1.0.cl Connections API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:15:45.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "lastUpdatedBy": "35240", "uid": "35240-5c2cff8a-7b4a-445f-ad88-4f80d7f82aa8" }, "item": [ { "name": "api", "item": [ { "name": "rest", "item": [ { "name": "2.0", "item": [ { "name": "connection", "item": [ { "name": "create", "item": [ { "name": "create Connection", "id": "ccd9879b-5c6c-43e7-bc8f-1613ef5b4e7d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"data_warehouse_type\": \"AZURE_SYNAPSE\",\n \"data_warehouse_config\": {},\n \"description\": \"\",\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "create" ] }, "description": "\n Version: 9.2.0.cl or later\n\nCreates a connection to a data warehouse for live query services.\n\nRequires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) privilege is required.\n\n#### Create a connection without tables\n\nTo create a connection without tables:\n\n1. Pass these parameters in your API request.\n * Name of the connection.\n * Type of the data warehouse to connect to.\n * A JSON map of configuration attributes in `data_warehouse_config`. The following example shows the configuration attributes for a SnowFlake connection:\n ```\n {\n \"configuration\":{\n \"accountName\":\"thoughtspot_partner\",\n \"user\":\"tsadmin\",\n \"password\":\"TestConn123\",\n \"role\":\"sysadmin\",\n \"warehouse\":\"MEDIUM_WH\"\n },\n \"authenticationType\": \"SERVICE_ACCOUNT\",\n \"databases\": [\"DB1\", \"DB2\"],\n \"externalDatabases\":[\n\n ]\n }\n ```\n2. Set `validate` to `false`.\n\n**NOTE:** If the `authentication_type` is anything other than SERVICE_ACCOUNT, you must explicitly provide the authenticationType property in the payload. If you do not specify authenticationType, the API will default to SERVICE_ACCOUNT as the authentication type.\n\n#### Create a connection with tables\n\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) and `CAN_MANAGE_WORKSHEET_VIEWS_TABLES` (**Can manage data models**) privilege is required.\n\nTo create a connection with tables:\n\n1. Pass these parameters in your API request.\n* Name of the connection.\n* Type of the data warehouse to connect to.\n* A JSON map of configuration attributes, database details, and table properties in `data_warehouse_config` as shown in the following example:\n ```\n {\n \"configuration\":{\n \"accountName\":\"thoughtspot_partner\",\n \"user\":\"tsadmin\",\n \"password\":\"TestConn123\",\n \"role\":\"sysadmin\",\n \"warehouse\":\"MEDIUM_WH\"\n },\n \"authenticationType\": \"SERVICE_ACCOUNT\",\n \"databases\": [\"DB1\", \"DB2\", \"AllDatatypes\"],\n \"externalDatabases\":[\n {\n \"name\":\"AllDatatypes\",\n \"isAutoCreated\":false,\n \"schemas\":[\n {\n \"name\":\"alldatatypes\",\n \"tables\":[\n {\n \"name\":\"allDatatypes\",\n \"type\":\"TABLE\",\n \"description\":\"\",\n \"selected\":true,\n \"linked\":true,\n \"columns\":[\n {\n \"name\":\"CNUMBER\",\n \"type\":\"INT64\",\n \"canImport\":true,\n \"selected\":true,\n \"isLinkedActive\":true,\n \"isImported\":false,\n \"tableName\":\"allDatatypes\",\n \"schemaName\":\"alldatatypes\",\n \"dbName\":\"AllDatatypes\"\n },\n {\n \"name\":\"CDECIMAL\",\n \"type\":\"INT64\",\n \"canImport\":true,\n \"selected\":true,\n \"isLinkedActive\":true,\n \"isImported\":false,\n \"tableName\":\"allDatatypes\",\n \"schemaName\":\"alldatatypes\",\n \"dbName\":\"AllDatatypes\"\n }\n ]\n }\n ]\n }\n ]\n }\n ]\n }\n ```\n2. Set `validate` to `true`.\n\n**NOTE:** If the `authentication_type` is anything other than SERVICE_ACCOUNT, you must explicitly provide the authenticationType property in the payload. If you do not specify authenticationType, the API will default to SERVICE_ACCOUNT as the authentication type.\n\nThe optional `databases` property in `data_warehouse_config` accepts a list of database names. When specified, ThoughtSpot persists this list on the connection and uses it to scope metadata fetching to only the specified databases in subsequent table add and remove operations. If omitted, all databases in the data warehouse are accessible for metadata operations.\n\nThe `databases` and `externalDatabases` serve different purposes. `databases` is a flat list of database names that controls which databases are scanned during metadata operations. `externalDatabases` defines the full table hierarchy and determines which tables are linked into ThoughtSpot.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "2704d3e3-9422-44a7-9f0d-aa677e98908b", "name": "Connection to the datasource successfully created.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"data_warehouse_type\": \"AZURE_SYNAPSE\",\n \"data_warehouse_config\": {},\n \"description\": \"\",\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "create" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"data_warehouse_type\": \"LOOKER\",\n \"details\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-2704d3e3-9422-44a7-9f0d-aa677e98908b" }, { "id": "a24a6a71-db3d-49e5-acae-50b76504f56f", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"data_warehouse_type\": \"AZURE_SYNAPSE\",\n \"data_warehouse_config\": {},\n \"description\": \"\",\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "create" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-a24a6a71-db3d-49e5-acae-50b76504f56f" }, { "id": "d476da17-6f6c-4d5e-8e2f-4ef4fa9edab8", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"data_warehouse_type\": \"AZURE_SYNAPSE\",\n \"data_warehouse_config\": {},\n \"description\": \"\",\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "create" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-d476da17-6f6c-4d5e-8e2f-4ef4fa9edab8" }, { "id": "10ad19d8-b7e0-46ee-9b00-fd8c15f1b9f3", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"data_warehouse_type\": \"AZURE_SYNAPSE\",\n \"data_warehouse_config\": {},\n \"description\": \"\",\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "create" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-10ad19d8-b7e0-46ee-9b00-fd8c15f1b9f3" }, { "id": "c0ec0ff0-e451-41ec-b0b4-dffaf6d261c3", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"data_warehouse_type\": \"AZURE_SYNAPSE\",\n \"data_warehouse_config\": {},\n \"description\": \"\",\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "create" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-c0ec0ff0-e451-41ec-b0b4-dffaf6d261c3" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-ccd9879b-5c6c-43e7-bc8f-1613ef5b4e7d" } ], "id": "9de96cd4-2f17-45af-8491-c30417434917", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-9de96cd4-2f17-45af-8491-c30417434917" }, { "name": "delete", "item": [ { "name": "delete Connection", "id": "3ced87b9-372c-4210-bf30-8472aa190090", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "delete" ] }, "description": "\n Version: 9.2.0.cl or later\n\n\n**Important**: This endpoint is deprecated and will be removed from ThoughtSpot in September 2025. ThoughtSpot strongly recommends using the\n[Delete Connection V2](#/http/api-endpoints/connections/delete-connection-v2) endpoint to delete your connection objects. \n\n#### Usage guidelines\n\nDeletes a connection object.\n\nRequires `DATAMANAGEMENT` (**Can manage data**) and edit permissions to the connection object, or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) privilege is required.\n\n**Note**: If a connection has dependent objects, make sure you remove its associations before the delete operation.\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "8ac8d6cc-fe82-4755-a071-53c1015ea046", "name": "Connection successfully deleted.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "delete" ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-8ac8d6cc-fe82-4755-a071-53c1015ea046" }, { "id": "3166aff2-51b1-46c9-87d0-044b3bc05157", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "delete" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-3166aff2-51b1-46c9-87d0-044b3bc05157" }, { "id": "b5d43578-5d60-4c0c-89d6-356d2c0391bf", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "delete" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-b5d43578-5d60-4c0c-89d6-356d2c0391bf" }, { "id": "6ad028a4-f482-4137-9d7e-23ffb89ac0a8", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "delete" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-6ad028a4-f482-4137-9d7e-23ffb89ac0a8" }, { "id": "b04eb797-2c50-4413-bc68-d8b08b75e49f", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "delete" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-b04eb797-2c50-4413-bc68-d8b08b75e49f" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-3ced87b9-372c-4210-bf30-8472aa190090" } ], "id": "395b5f15-88e2-447a-b1b8-92bbae8b2061", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-395b5f15-88e2-447a-b1b8-92bbae8b2061" }, { "name": "search", "item": [ { "name": "search Connection", "id": "979e40f1-ebfd-4b4f-893b-46447bdbb0f8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"connections\": [\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n },\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n }\n ],\n \"data_warehouse_types\": [\n \"AMAZON_RDS_POSTGRESQL\",\n \"AMAZON_RDS_MYSQL\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"data_warehouse_object_type\": \"COLUMN\",\n \"sort_options\": {\n \"field_name\": \"USER_STATE\",\n \"order\": \"ASC\"\n },\n \"include_details\": \"\",\n \"configuration\": {},\n \"authentication_type\": \"SERVICE_ACCOUNT\",\n \"show_resolved_parameters\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "search" ] }, "description": "\n Version: 9.2.0.cl or later\n\nGets connection objects.\nRequires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) privilege is required.\n\n- To get a list of all connections available in the ThoughtSpot system, send the API request without any attributes in the request body.\n- To get the connection objects for a specific type of data warehouse, specify the type in `data_warehouse_types`.\n- To fetch details of a connection object, specify the connection object GUID or name. The `name_pattern` attribute allows passing partial text with `%` for a wildcard match.\n- To get details of the database, schemas, tables, or columns from a data connection object, specify `data_warehouse_object_type`.\n- To get a specific database, schema, table, or column from a connection object, define the object type in `data_warehouse_object_type` and object properties in the `data_warehouse_objects` array. For example, to search for a column, you must pass the database, schema, and table names in the API request.\n Note that in the following example, object properties are set in a hierarchical order (`database` > `schema` > `table` > `column`).\n\n```\n{\n \"connections\": [\n {\n \"identifier\": \"b9d1f2ef-fa65-4a4b-994e-30fa2d57b0c2\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"NEBULADEV\",\n \"schema\": \"INFORMATION_SCHEMA\",\n \"table\": \"APPLICABLE_ROLES\",\n \"column\": \"ROLE_NAME\"\n }\n ]\n }\n ],\n \"data_warehouse_object_type\": \"COLUMN\"\n}\n```\n\n- To fetch data by `configuration`, specify `data_warehouse_object_type`. For example, to fetch columns from the `DEVELOPMENT` database, specify the `data_warehouse_object_type` as `DATABASE` and define the `configuration` string as `{\"database\":\"DEVELOPMENT\"}`. To get column data for a specific table, specify the table, for example,`{\"database\":\"RETAILAPPAREL\",\"table\":\"PIPES\"}`.\n- To query connections by `authentication_type`, specify `data_warehouse_object_type`. Supported values for `authentication_type` are:\n - `SERVICE_ACCOUNT`: For connections that require service account credentials to authenticate to the Cloud Data Warehouse and fetch data.\n - `OAUTH`: For connections that require OAuth credentials to authenticate to the Cloud Data Warehouse and fetch data. Teradata, Oracle, and Presto Cloud Data Warehouses do not support the OAuth authentication type.\n - `IAM`: For connections that have the IAM OAuth set up. This authentication type is supported on Amazon Redshift connections only.\n - `EXTOAUTH`: For connections that have External OAuth set up. ThoughtSpot supports external [OAuth with Microsoft Azure Active Directory (AD)](https://docs.thoughtspot.com/cloud/latest/ connections-snowflake-azure-ad-oauth) and [Okta for Snowflake data connections](https://docs.thoughtspot.com/cloud/latest/connections-snowflake-okta-oauth).\n - `KEY_PAIR`: For connections that require Key Pair account credentials to authenticate to the Cloud Data Warehouse and fetch data. This authentication type is supported on Snowflake connections only.\n - `OAUTH_WITH_PKCE`: For connections that require OAuth with PKCE account credentials to authenticate to the Cloud Data Warehouse and fetch data. This authentication type is supported on Snowflake, Starburst, Databricks, Denodo connections only.\n - `EXTOAUTH_WITH_PKCE`: For connections that require External OAuth With PKCE account credentials to authenticate to the Cloud Data Warehouse and fetch data. This authentication type is supported on Snowflake connections only.\n - `OAUTH_WITH_PEZ`: For connections that require OAuth With PEZ account credentials to authenticate to the Cloud Data Warehouse and fetch data. This authentication type is supported on Amazon Redshift connections only.\n - `OAUTH_WITH_SERVICE_PRINCIPAL`: For connections that require OAuth With Service Principal account credentials to authenticate to the Cloud Data Warehouse and fetch data. This authentication type is supported on Databricks connections only.\n - `PERSONAL_ACCESS_TOKEN`: For connections that require Personal Access Token account credentials to authenticate to the Cloud Data Warehouse and fetch data. This authentication type is supported on Databricks connections only.\n - `OAUTH_CLIENT_CREDENTIALS`: For connections that require OAuth Client Credentials to authenticate to the Cloud Data Warehouse and fetch data. This authentication type is supported on Snowflake connections only.\n- To include more details about connection objects in the API response, set `include_details` to `true`.\n- You can also sort the output by field names and filter connections by tags.\n\n**NOTE**: In addition to the connection GUID and name, the `identifier` field on each entry in `connections` accepts a Custom object ID if one is configured for the connection. The response also includes the `obj_id` field for each connection that has one set.\n\n**NOTE**: When filtering connection records by parameters other than `data_warehouse_types` or `tag_identifiers`, ensure that you set `record_size` to `-1` and `record_offset` to `0` for precise results.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "bf2aa9a1-31b3-47a2-b25a-775eec6d53f2", "name": "List of connections to the datasource.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connections\": [\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n },\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n }\n ],\n \"data_warehouse_types\": [\n \"AMAZON_RDS_POSTGRESQL\",\n \"AMAZON_RDS_MYSQL\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"data_warehouse_object_type\": \"COLUMN\",\n \"sort_options\": {\n \"field_name\": \"USER_STATE\",\n \"order\": \"ASC\"\n },\n \"include_details\": \"\",\n \"configuration\": {},\n \"authentication_type\": \"SERVICE_ACCOUNT\",\n \"show_resolved_parameters\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "search" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"id\": \"\",\n \"name\": \"\",\n \"data_warehouse_type\": \"AZURE_SYNAPSE\",\n \"obj_id\": \"\",\n \"description\": \"\",\n \"data_warehouse_objects\": {\n \"databases\": [\n {\n \"name\": \"\",\n \"schemas\": [\n {\n \"name\": \"\",\n \"tables\": [\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n },\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n }\n ]\n },\n {\n \"name\": \"\",\n \"tables\": [\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n },\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n }\n ]\n }\n ],\n \"auto_created\": \"\"\n },\n {\n \"name\": \"\",\n \"schemas\": [\n {\n \"name\": \"\",\n \"tables\": [\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n },\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n }\n ]\n },\n {\n \"name\": \"\",\n \"tables\": [\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n },\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n }\n ]\n }\n ],\n \"auto_created\": \"\"\n }\n ]\n },\n \"details\": {}\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"data_warehouse_type\": \"ORACLE_ADW\",\n \"obj_id\": \"\",\n \"description\": \"\",\n \"data_warehouse_objects\": {\n \"databases\": [\n {\n \"name\": \"\",\n \"schemas\": [\n {\n \"name\": \"\",\n \"tables\": [\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n },\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n }\n ]\n },\n {\n \"name\": \"\",\n \"tables\": [\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n },\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n }\n ]\n }\n ],\n \"auto_created\": \"\"\n },\n {\n \"name\": \"\",\n \"schemas\": [\n {\n \"name\": \"\",\n \"tables\": [\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n },\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n }\n ]\n },\n {\n \"name\": \"\",\n \"tables\": [\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n },\n {\n \"name\": \"\",\n \"columns\": [\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n },\n {\n \"name\": \"\",\n \"data_type\": \"\",\n \"is_aggregate\": \"\",\n \"can_import\": \"\",\n \"selected\": \"\",\n \"is_linked_active\": \"\"\n }\n ],\n \"type\": \"\",\n \"description\": \"\",\n \"selected\": \"\",\n \"linked\": \"\"\n }\n ]\n }\n ],\n \"auto_created\": \"\"\n }\n ]\n },\n \"details\": {}\n }\n]", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-bf2aa9a1-31b3-47a2-b25a-775eec6d53f2" }, { "id": "0772af39-b396-410a-aea6-8a099b4c6bfe", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connections\": [\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n },\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n }\n ],\n \"data_warehouse_types\": [\n \"AMAZON_RDS_POSTGRESQL\",\n \"AMAZON_RDS_MYSQL\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"data_warehouse_object_type\": \"COLUMN\",\n \"sort_options\": {\n \"field_name\": \"USER_STATE\",\n \"order\": \"ASC\"\n },\n \"include_details\": \"\",\n \"configuration\": {},\n \"authentication_type\": \"SERVICE_ACCOUNT\",\n \"show_resolved_parameters\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "search" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-0772af39-b396-410a-aea6-8a099b4c6bfe" }, { "id": "faa4f859-2a85-474b-8638-ede3e9f1822f", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connections\": [\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n },\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n }\n ],\n \"data_warehouse_types\": [\n \"AMAZON_RDS_POSTGRESQL\",\n \"AMAZON_RDS_MYSQL\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"data_warehouse_object_type\": \"COLUMN\",\n \"sort_options\": {\n \"field_name\": \"USER_STATE\",\n \"order\": \"ASC\"\n },\n \"include_details\": \"\",\n \"configuration\": {},\n \"authentication_type\": \"SERVICE_ACCOUNT\",\n \"show_resolved_parameters\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "search" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-faa4f859-2a85-474b-8638-ede3e9f1822f" }, { "id": "07ce1694-fac2-43e5-9638-6b200bdd9bef", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connections\": [\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n },\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n }\n ],\n \"data_warehouse_types\": [\n \"AMAZON_RDS_POSTGRESQL\",\n \"AMAZON_RDS_MYSQL\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"data_warehouse_object_type\": \"COLUMN\",\n \"sort_options\": {\n \"field_name\": \"USER_STATE\",\n \"order\": \"ASC\"\n },\n \"include_details\": \"\",\n \"configuration\": {},\n \"authentication_type\": \"SERVICE_ACCOUNT\",\n \"show_resolved_parameters\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "search" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-07ce1694-fac2-43e5-9638-6b200bdd9bef" }, { "id": "e7c5369b-238f-4b9e-9e11-9f8ebae5ce89", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connections\": [\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n },\n {\n \"identifier\": \"\",\n \"name_pattern\": \"\",\n \"data_warehouse_objects\": [\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n },\n {\n \"database\": \"\",\n \"schema\": \"\",\n \"table\": \"\",\n \"column\": \"\"\n }\n ]\n }\n ],\n \"data_warehouse_types\": [\n \"AMAZON_RDS_POSTGRESQL\",\n \"AMAZON_RDS_MYSQL\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"data_warehouse_object_type\": \"COLUMN\",\n \"sort_options\": {\n \"field_name\": \"USER_STATE\",\n \"order\": \"ASC\"\n },\n \"include_details\": \"\",\n \"configuration\": {},\n \"authentication_type\": \"SERVICE_ACCOUNT\",\n \"show_resolved_parameters\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "search" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-e7c5369b-238f-4b9e-9e11-9f8ebae5ce89" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-979e40f1-ebfd-4b4f-893b-46447bdbb0f8" } ], "id": "e66cc829-7b0f-4e59-8d09-217923e224e0", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-e66cc829-7b0f-4e59-8d09-217923e224e0" }, { "name": "update", "item": [ { "name": "update Connection", "id": "fce2ddff-91c2-4a18-a1c6-ae8648d73b9b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "update" ] }, "description": "\n Version: 9.2.0.cl or later\n\n**Important**: This endpoint is deprecated and will be removed from ThoughtSpot in September 2025. ThoughtSpot strongly recommends using the\n[Update connection V2](#/http/api-endpoints/connections/update-connection-v2) endpoint to update your connection objects.\n\n#### Usage guidelines\n\nUpdates a connection object. \n\nRequires `DATAMANAGEMENT` (**Can manage data**) and edit permissions to the connection object, or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) privilege is required.\n\nTo update a connection object, pass these parameters in your API request:\n\n1. GUID of the connection object.\n2. If you are updating tables or database schema of a connection object:\n a. Add the updated JSON map of metadata with database, schema, and tables in `data_warehouse_config`.\n b. Set `validate` to `true`.\n3. If you are updating a configuration attribute, connection name, or description, you can set `validate` to `false`.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "d40a2233-feb2-4239-a368-c4dea2f78a2c", "name": "Connection successfully updated.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "update" ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-d40a2233-feb2-4239-a368-c4dea2f78a2c" }, { "id": "20847636-71fa-4470-bc16-b8dcd23ddb03", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "update" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-20847636-71fa-4470-bc16-b8dcd23ddb03" }, { "id": "090aa2b0-2a2a-477b-8eb2-83f24b539fec", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "update" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-090aa2b0-2a2a-477b-8eb2-83f24b539fec" }, { "id": "c94b3015-55b4-478c-aa0c-d95876b112f4", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "update" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-c94b3015-55b4-478c-aa0c-d95876b112f4" }, { "id": "8b2f7f72-7744-4f1c-8f40-240a083c155e", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"connection_identifier\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connection/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connection", "update" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-8b2f7f72-7744-4f1c-8f40-240a083c155e" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-fce2ddff-91c2-4a18-a1c6-ae8648d73b9b" } ], "id": "fd635fa3-af76-4075-8b22-b7748a6e381d", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-fd635fa3-af76-4075-8b22-b7748a6e381d" } ], "id": "129a6b18-8ec5-4a01-a6c9-20dd22794b02", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-129a6b18-8ec5-4a01-a6c9-20dd22794b02" }, { "name": "connections", "item": [ { "name": "{connection_identifier}", "item": [ { "name": "delete", "item": [ { "name": "delete Connection V2", "id": "eaca0c3f-128f-4460-8a30-4ee6a7fd9ea8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "delete" ], "variable": [ { "id": "2fbed1da-f021-4538-a456-d921f0ed72de", "key": "connection_identifier", "value": "", "description": "(Required) Unique ID or name of the connection." } ] }, "description": "\n Version: 10.4.0.cl or later\n\nDeletes a connection object.\n\n**Note**: If a connection has dependent objects, make sure you remove its associations before the delete operation.\n\nRequires `DATAMANAGEMENT` (**Can manage data**) and edit permissions to the connection object, or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) privilege is required.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "99c7f63e-80b8-4331-8ed7-c11063130874", "name": "Connection successfully deleted.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "delete" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-99c7f63e-80b8-4331-8ed7-c11063130874" }, { "id": "9d6b81a0-fc36-4eb9-9a2e-c0db59bb469d", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "delete" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-9d6b81a0-fc36-4eb9-9a2e-c0db59bb469d" }, { "id": "f0c1a6e2-ec8e-4e6e-b8e9-835fbc7a3898", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "delete" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-f0c1a6e2-ec8e-4e6e-b8e9-835fbc7a3898" }, { "id": "95d607f6-cd52-4cbc-a530-fced9ee05476", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "delete" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-95d607f6-cd52-4cbc-a530-fced9ee05476" }, { "id": "933dc749-b3c9-4afd-8dd7-29002063a480", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "delete" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-933dc749-b3c9-4afd-8dd7-29002063a480" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-eaca0c3f-128f-4460-8a30-4ee6a7fd9ea8" } ], "id": "264385a8-59c0-4217-9838-7358f61153cf", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-264385a8-59c0-4217-9838-7358f61153cf" }, { "name": "revoke-refresh-tokens", "item": [ { "name": "revoke Refresh Tokens", "id": "5784316d-4849-4e7b-95b9-3903ae798abb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"configuration_identifiers\": [\n \"\",\n \"\"\n ],\n \"user_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/revoke-refresh-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "revoke-refresh-tokens" ], "variable": [ { "id": "d7a7e3c0-e489-4b7f-bbfa-bde3553b52dc", "key": "connection_identifier", "value": "", "description": "(Required) 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." } ] }, "description": "\n Version: 26.2.0.cl or later\n\nRevokes OAuth refresh tokens for users who no longer require access to a data warehouse connection.\nWhen a token is revoked, the affected user's session for that connection is terminated, and they must re-authenticate to regain access.\n\nRequires `ADMINISTRATION` (**Can administer ThoughtSpot**) or `DATAMANAGEMENT` (**Can manage data**) privileges.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on the ThoughtSpot instance, users with `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) privilege can also make API requests to revoke tokens for connection users.\n\n#### Usage guidelines\n\nYou can specify different combinations of identifiers to control which refresh tokens are revoked.\n\n- **connection_identifier**: Revokes refresh tokens for all users of the connection, except the connection author.\n- **connection_identifier** and **user_identifiers**: Revokes refresh tokens only for the users specified in the request. If the name or ID of the connection author is included in the request, their token will also be revoked.\n- **connection_identifier** and **configuration_identifiers**: Revokes refresh tokens for all users on the specified configurations, except the configuration author.\n- **connection_identifier**, **configuration_identifiers**, and **user_identifiers**: Revokes refresh tokens for the specified users on the specified configurations.\n- **connection_identifier** and **org_identifiers**: Revokes refresh tokens for the specified Orgs. Applicable only for published connections.\n- **connection_identifier**, **org_identifiers**, and **user_identifiers**: Revokes refresh tokens for the specified users in the specified Orgs. Applicable only for published connections.\n\n**NOTE**: The `org_identifiers` parameter is only applicable for published connections. Using this parameter for unpublished connections will result in an error. Ensure that the connections are published before making the API request.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "0361c08c-1ce6-46ec-b0b9-13d2532853c2", "name": "Token(s) successfully revoked.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"configuration_identifiers\": [\n \"\",\n \"\"\n ],\n \"user_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/revoke-refresh-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "revoke-refresh-tokens" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": \"\"\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-0361c08c-1ce6-46ec-b0b9-13d2532853c2" }, { "id": "be319525-7ea1-4711-9ac3-bf2b3de6595c", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"configuration_identifiers\": [\n \"\",\n \"\"\n ],\n \"user_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/revoke-refresh-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "revoke-refresh-tokens" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-be319525-7ea1-4711-9ac3-bf2b3de6595c" }, { "id": "f6c9adaa-ef96-454e-8169-f397fc143b3e", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"configuration_identifiers\": [\n \"\",\n \"\"\n ],\n \"user_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/revoke-refresh-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "revoke-refresh-tokens" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-f6c9adaa-ef96-454e-8169-f397fc143b3e" }, { "id": "d2dd4764-0e06-40fb-a810-76835a720378", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"configuration_identifiers\": [\n \"\",\n \"\"\n ],\n \"user_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/revoke-refresh-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "revoke-refresh-tokens" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-d2dd4764-0e06-40fb-a810-76835a720378" }, { "id": "3bc7791b-69a8-4bc3-acb5-135930140aca", "name": "Object not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"configuration_identifiers\": [\n \"\",\n \"\"\n ],\n \"user_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/revoke-refresh-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "revoke-refresh-tokens" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-3bc7791b-69a8-4bc3-acb5-135930140aca" }, { "id": "fbea753a-f4d4-4a34-9042-07a02aa12ccb", "name": "Conflict", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"configuration_identifiers\": [\n \"\",\n \"\"\n ],\n \"user_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/revoke-refresh-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "revoke-refresh-tokens" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-fbea753a-f4d4-4a34-9042-07a02aa12ccb" }, { "id": "82b6189a-f5ee-4db1-8f19-3dac6d04543d", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"configuration_identifiers\": [\n \"\",\n \"\"\n ],\n \"user_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/revoke-refresh-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "revoke-refresh-tokens" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-82b6189a-f5ee-4db1-8f19-3dac6d04543d" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-5784316d-4849-4e7b-95b9-3903ae798abb" } ], "id": "5f56bdda-9739-4ce1-aee5-a33b9947254b", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-5f56bdda-9739-4ce1-aee5-a33b9947254b" }, { "name": "resync-metadata", "item": [ { "name": "sync Metadata", "id": "a94bf26f-66f8-4190-89e9-4d7445ba9f3e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"tables\": {},\n \"sync_attributes\": [\n \"DESCRIPTION\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/resync-metadata", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "resync-metadata" ], "variable": [ { "id": "0f21cc15-6c9c-4765-911c-5f0a5cfee193", "key": "connection_identifier", "value": "", "description": "(Required) Unique ID or name of the connection." } ] }, "description": "\n Version: 26.5.0.cl or later\n\nSynchronizes connection metadata attributes from your Cloud Data Warehouse (CDW) with ThoughtSpot.\n\nRequires the `DATAMANAGEMENT` (**Can manage data**) privilege. If [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_MANAGE_WORKSHEET_VIEWS_TABLES` (**Can manage data models**) privilege is required.\n\n#### Usage guidelines\n\nTo synchronize attributes from a CDW, specify the connection GUID or name in the `connection_identifier` path parameter and `sync_attributes` in the request body. Default attribute is `[\"DESCRIPTION\"]`.\n\n##### Hierarchical schema\n\n* Connection: The connection object for the sync operation.\n* Tables: Tables for the sync operation. When no table is specified, all tables are synchronized.\n* Columns: If the table is specified, you can add the columns for the sync operation. If no columns are specified, all columns in the specified table are considered for the sync operation.\n\nTo set the scope for the sync operation:\n\n* Connection-level: To sync all tables and columns, pass an empty request body, or only the attributes in the request body.\n* Table-level: To synchronize specific tables and their columns, specify the table identifiers in the `tables` array.\n* Column-level: To synchronize specific columns, specify the table identifier as the key and column identifiers as the value in the `tables` array.\n\n```\n{\n \"tables\": [\n {\"table-guid-1\": [\"column-guid-1\", \"column-guid-2\"]},\n \"table-guid-2\"\n ],\n \"sync_attributes\": [\"DESCRIPTION\"]\n}\n```\n\n##### API response\n\nIf the sync operation is successful, the API returns the following information:\n\n* Status of the sync operation. For example, `SUCCESS`, `PARTIAL_SUCCESS`, or `NO_UPDATE`.\n* Number of tables and columns that were updated.\n* Number of tables and columns with the sync failed status when the overall sync status is `PARTIAL_SUCCESS`.\n* Message text indicating the sync results.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "dbaa83c4-37a2-4cda-a7e4-c29b1be556f9", "name": "Metadata synced successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"tables\": {},\n \"sync_attributes\": [\n \"DESCRIPTION\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/resync-metadata", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "resync-metadata" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"SUCCESS\",\n \"tables_updated\": \"\",\n \"columns_updated\": \"\",\n \"tables_failed\": \"\",\n \"columns_failed\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-dbaa83c4-37a2-4cda-a7e4-c29b1be556f9" }, { "id": "73a9b83d-8e65-4482-be20-57eae7779891", "name": "Invalid request parameters or hierarchy.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"tables\": {},\n \"sync_attributes\": [\n \"DESCRIPTION\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/resync-metadata", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "resync-metadata" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-73a9b83d-8e65-4482-be20-57eae7779891" }, { "id": "1dd4d585-8289-4228-9498-1c58700e5ac0", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"tables\": {},\n \"sync_attributes\": [\n \"DESCRIPTION\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/resync-metadata", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "resync-metadata" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-1dd4d585-8289-4228-9498-1c58700e5ac0" }, { "id": "cb8c2596-e146-4277-adc0-81c2882b6fb2", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"tables\": {},\n \"sync_attributes\": [\n \"DESCRIPTION\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/resync-metadata", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "resync-metadata" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-cb8c2596-e146-4277-adc0-81c2882b6fb2" }, { "id": "8b1aba20-6bd0-402f-9ba8-1ce0a97c4f60", "name": "Connection, table, or column not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"tables\": {},\n \"sync_attributes\": [\n \"DESCRIPTION\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/resync-metadata", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "resync-metadata" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-8b1aba20-6bd0-402f-9ba8-1ce0a97c4f60" }, { "id": "a6000a01-e561-4dce-9fce-d208f0a5a7c7", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"tables\": {},\n \"sync_attributes\": [\n \"DESCRIPTION\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/resync-metadata", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "resync-metadata" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-a6000a01-e561-4dce-9fce-d208f0a5a7c7" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-a94bf26f-66f8-4190-89e9-4d7445ba9f3e" } ], "id": "eb766989-bac1-4f03-8400-fe9c56f355b9", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-eb766989-bac1-4f03-8400-fe9c56f355b9" }, { "name": "status", "item": [ { "name": "update Connection Status", "id": "e9311cf6-147f-402f-8816-8d8a2dc9455c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"ACTIVATED\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "status" ], "variable": [ { "id": "076804fa-9964-4b51-8a46-09cc901969e6", "key": "connection_identifier", "value": "", "description": "(Required) Unique ID or name of the connection." } ] }, "description": "\n Version: 26.6.0.cl or later\n\nActivates or deactivates a connection. A deactivated connection cannot be used for queries or operations until it is activated again.\n\nRequires `DATAMANAGEMENT` (**Can manage data**) privilege. If [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) privilege is required. Only the connection owner or an administrator can perform this operation.\n\n#### Usage guidelines\n\nTo update the status of a connection, specify the connection GUID or name in the `connection_identifier` path parameter and the desired `status` in the request body.\n\n- **ACTIVATED**: Enables the connection. Queries and operations can resume on an activated connection.\n- **DEACTIVATED**: Disables the connection. It does not remove the connection metadata, but only makes the connection unavailable for queries and operations. You can reactivate a deactivated connection by setting \"status\": \"ACTIVATED\".\n\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "5e32df00-cc64-409a-9528-4e749e98a0ba", "name": "Connection status updated successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"ACTIVATED\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "status" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-5e32df00-cc64-409a-9528-4e749e98a0ba" }, { "id": "7737f48a-6bb1-474e-a701-b41750f8f7bb", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"ACTIVATED\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "status" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-7737f48a-6bb1-474e-a701-b41750f8f7bb" }, { "id": "dbc9f75a-f230-4703-ad3e-9aad29e43251", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"ACTIVATED\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "status" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-dbc9f75a-f230-4703-ad3e-9aad29e43251" }, { "id": "9e040c9e-9cec-4693-b888-cb5c3c404278", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"ACTIVATED\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "status" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-9e040c9e-9cec-4693-b888-cb5c3c404278" }, { "id": "d9eade92-83b4-4a6d-b958-3efc32229ddf", "name": "Object not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"ACTIVATED\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "status" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-d9eade92-83b4-4a6d-b958-3efc32229ddf" }, { "id": "e14b84f3-740c-47c4-917c-2fed82918bb8", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"ACTIVATED\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "status" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-e14b84f3-740c-47c4-917c-2fed82918bb8" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-e9311cf6-147f-402f-8816-8d8a2dc9455c" } ], "id": "7d140465-923c-47ad-96a8-192be049b66d", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-7d140465-923c-47ad-96a8-192be049b66d" }, { "name": "update", "item": [ { "name": "update Connection V2", "id": "1ecd185d-4c77-4a85-9e65-152ff4261e01", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "update" ], "variable": [ { "id": "44132840-8c0a-4dab-8da5-e0e962afe535", "key": "connection_identifier", "value": "", "description": "(Required) Unique ID or name of the connection." } ] }, "description": "\n Version: 10.4.0.cl or later\n\nUpdates a connection object.\n\nRequires `DATAMANAGEMENT` (**Can manage data**) and edit permissions to the connection object, or `ADMINISTRATION` (**Can administer ThoughtSpot**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**) privilege is required.\n\nTo update a connection object, pass these parameters in your API request:\n\n1. GUID of the connection object.\n2. If you are updating tables or database schema of a connection object:\n a. Add the updated JSON map of metadata with database, schema, and tables in `data_warehouse_config`.\n b. Set `validate` to `true`.\n \n **NOTE:** If the `authentication_type` is anything other than SERVICE_ACCOUNT, you must explicitly provide the authenticationType property in the payload. If you do not specify authenticationType, the API will default to SERVICE_ACCOUNT as the authentication type.\n\n * A JSON map of configuration attributes, database details, and table properties in `data_warehouse_config` as shown in the following example:\n * This is an example of updating a single table in a empty connection:\n \n ```\n {\n \"authenticationType\": \"SERVICE_ACCOUNT\",\n \"databases\": [\"DB2\", \"DB3\", \"DEVELOPMENT\"],\n \"externalDatabases\": [\n {\n \"name\": \"DEVELOPMENT\",\n \"isAutoCreated\": false,\n \"schemas\": [\n {\n \"name\": \"TS_dataset\",\n \"tables\": [\n {\n \"name\": \"DEMORENAME\",\n \"type\": \"TABLE\",\n \"description\": \"\",\n \"selected\": true,\n \"linked\": true,\n \"gid\": 0,\n \"datasetId\": \"-1\",\n \"subType\": \"\",\n \"reportId\": \"\",\n \"viewId\": \"\",\n \"columns\": [\n {\n \"name\": \"Col1\",\n \"type\": \"VARCHAR\",\n \"canImport\": true,\n \"selected\": true,\n \"description\": \"\",\n \"isLinkedActive\": true,\n \"isAggregate\": false\n },\n {\n \"name\": \"Col2\",\n \"type\": \"VARCHAR\",\n \"canImport\": true,\n \"selected\": true,\n \"description\": \"\",\n \"isLinkedActive\": true,\n \"isAggregate\": false\n },\n {\n \"name\": \"Col3\",\n \"type\": \"VARCHAR\",\n \"canImport\": true,\n \"selected\": true,\n \"description\": \"\",\n \"isLinkedActive\": true,\n \"isAggregate\": false\n },\n {\n \"name\": \"Col312\",\n \"type\": \"VARCHAR\",\n \"canImport\": true,\n \"selected\": true,\n \"description\": \"\",\n \"isLinkedActive\": true,\n \"isAggregate\": false\n },\n {\n \"name\": \"Col4\",\n \"type\": \"VARCHAR\",\n \"canImport\": true,\n \"selected\": true,\n \"description\": \"\",\n \"isLinkedActive\": true,\n \"isAggregate\": false\n }\n ],\n \"relationships\": []\n }\n ]\n }\n ]\n }\n ],\n \"configuration\": {\n \"password\": \"\",\n \"database\": \"DEVELOPMENT\",\n \"role\": \"DEV\",\n \"accountName\": \"thoughtspot_partner\",\n \"warehouse\": \"DEMO_WH\",\n \"user\": \"DEV_USER\"\n }\n }\n ```\n \n* This is an example of updating a single table in an existing connection with tables:\n \n ```\n {\n \"authenticationType\": \"SERVICE_ACCOUNT\",\n \"databases\": [\"DB2\", \"DB3\", \"DEVELOPMENT\"],\n \"externalDatabases\": [\n {\n \"name\": \"DEVELOPMENT\",\n \"isAutoCreated\": false,\n \"schemas\": [\n {\n \"name\": \"TS_dataset\",\n \"tables\": [\n {\n \"name\": \"CUSTOMER\",\n \"type\": \"TABLE\",\n \"description\": \"\",\n \"selected\": true,\n \"linked\": true,\n \"gid\": 0,\n \"datasetId\": \"-1\",\n \"subType\": \"\",\n \"reportId\": \"\",\n \"viewId\": \"\",\n \"columns\": [],\n \"relationships\": []\n },\n {\n \"name\": \"tpch5k_falcon_default_schema_users\",\n \"type\": \"TABLE\",\n \"description\": \"\",\n \"selected\": true,\n \"linked\": true,\n \"gid\": 0,\n \"datasetId\": \"-1\",\n \"subType\": \"\",\n \"reportId\": \"\",\n \"viewId\": \"\",\n \"columns\": [\n {\n \"name\": \"user_id\",\n \"type\": \"INT64\",\n \"canImport\": true,\n \"selected\": true,\n \"description\": \"\",\n \"isLinkedActive\": true,\n \"isAggregate\": false\n },\n {\n \"name\": \"product_id\",\n \"type\": \"INT64\",\n \"canImport\": true,\n \"selected\": true,\n \"description\": \"\",\n \"isLinkedActive\": true,\n \"isAggregate\": false\n },\n {\n \"name\": \"user_cost\",\n \"type\": \"INT64\",\n \"canImport\": true,\n \"selected\": true,\n \"description\": \"\",\n \"isLinkedActive\": true,\n \"isAggregate\": false\n }\n ],\n \"relationships\": []\n }\n ]\n }\n ]\n }\n ],\n \"configuration\": {\n \"password\": \"\",\n \"database\": \"DEVELOPMENT\",\n \"role\": \"DEV\",\n \"accountName\": \"thoughtspot_partner\",\n \"warehouse\": \"DEMO_WH\",\n \"user\": \"DEV_USER\"\n }\n }\n ```\n\n3. If you are updating a configuration attribute, connection name, or description, you can set `validate` to `false`.\n\n **NOTE:** If the `authentication_type` is anything other than SERVICE_ACCOUNT, you must explicitly provide the authenticationType property in the payload. If you do not specify authenticationType, the API will default to SERVICE_ACCOUNT as the authentication type.\n\n * A JSON map of configuration attributes in `data_warehouse_config`. The following example shows the configuration attributes for a Snowflake connection:\n ```\n {\n \"configuration\":{\n \"accountName\":\"thoughtspot_partner\",\n \"user\":\"tsadmin\",\n \"password\":\"TestConn123\",\n \"role\":\"sysadmin\",\n \"warehouse\":\"MEDIUM_WH\"\n },\n \"databases\":[\"DB1\", \"DB2\"],\n \"externalDatabases\":[\n\n ]\n }\n ```\n\nThe optional `databases` property in `data_warehouse_config` accepts a list of database names. When specified, ThoughtSpot persists this list on the connection and uses it to scope metadata fetching to only the specified databases in subsequent table add and remove operations. If omitted, all databases in the data warehouse are accessible for metadata operations.\n\nThe `databases` and `externalDatabases` serve different purposes. `databases` is a flat list of database names that controls which databases are scanned during metadata operations. `externalDatabases` defines the full table hierarchy and determines which tables are linked into ThoughtSpot.\n\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "0dcc80c5-629b-4b52-b89e-6c1ac3cb7bff", "name": "Connection successfully updated.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "update" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-0dcc80c5-629b-4b52-b89e-6c1ac3cb7bff" }, { "id": "247023b6-42e0-475c-8e6c-1d188286db08", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "update" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-247023b6-42e0-475c-8e6c-1d188286db08" }, { "id": "71f1eea4-7326-4486-a631-1364409e5647", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "update" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-71f1eea4-7326-4486-a631-1364409e5647" }, { "id": "19451a25-6cff-43ea-820b-f63251b34736", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "update" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-19451a25-6cff-43ea-820b-f63251b34736" }, { "id": "4ddd8b49-a304-4683-b392-840ea253bec5", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"data_warehouse_config\": {},\n \"validate\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/:connection_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", ":connection_identifier", "update" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-4ddd8b49-a304-4683-b392-840ea253bec5" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-1ecd185d-4c77-4a85-9e65-152ff4261e01" } ], "id": "5a21d5e9-eed9-433d-a2db-37739b5bcd76", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-5a21d5e9-eed9-433d-a2db-37739b5bcd76" } ], "id": "dce81173-ac73-4132-b90a-aa721506fe31", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-dce81173-ac73-4132-b90a-aa721506fe31" }, { "name": "download-connection-metadata-changes", "item": [ { "name": "{connection_identifier}", "item": [ { "name": "download Connection Metadata Changes", "id": "060ae33e-5c0d-43a3-8646-c687908b36f6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/octet-stream" } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/download-connection-metadata-changes/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "download-connection-metadata-changes", ":connection_identifier" ], "variable": [ { "id": "26b1fd46-9f2d-485a-9121-99c06af12b20", "key": "connection_identifier", "value": "", "description": "(Required) GUID of the connection" } ] }, "description": "\n Version: 9.9.0.cl or later\n\nExports the difference in connection metadata between CDW and ThoughtSpot\n\nRequires `DATAMANAGEMENT` (**Can manage data**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the following Data control privileges may be required: \n- `CAN_MANAGE_CUSTOM_CALENDAR`(**Can manage custom calendars**)\n- `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**)\n- `CAN_MANAGE_WORKSHEET_VIEWS_TABLES` (**Can manage data models**)\n\nTo download the connection metadata difference between ThoughtSpot and CDW, pass the connection GUID as `connection_identifier` in the API request.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "2b07aa1e-44d1-42dd-8198-173e6a514897", "name": "Export metadata changes.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/octet-stream" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/download-connection-metadata-changes/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "download-connection-metadata-changes", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "key": "Content-Type", "value": "application/octet-stream" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-2b07aa1e-44d1-42dd-8198-173e6a514897" }, { "id": "6f4a6358-fb19-48e3-bc1c-6bdef5322fc1", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/download-connection-metadata-changes/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "download-connection-metadata-changes", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-6f4a6358-fb19-48e3-bc1c-6bdef5322fc1" }, { "id": "5132fb6e-4527-4abc-b62f-caf28bd4cbdf", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/download-connection-metadata-changes/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "download-connection-metadata-changes", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-5132fb6e-4527-4abc-b62f-caf28bd4cbdf" }, { "id": "b125d0f5-83b8-45a8-815a-e6cf9ba012d0", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/download-connection-metadata-changes/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "download-connection-metadata-changes", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-b125d0f5-83b8-45a8-815a-e6cf9ba012d0" }, { "id": "f2292027-74ef-4ae0-9e65-f4090e719526", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/download-connection-metadata-changes/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "download-connection-metadata-changes", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-f2292027-74ef-4ae0-9e65-f4090e719526" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-060ae33e-5c0d-43a3-8646-c687908b36f6" } ], "id": "198c593b-3dee-45e7-81c0-e88a4ec9b322", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-198c593b-3dee-45e7-81c0-e88a4ec9b322" } ], "id": "5d3b10cb-9c60-436d-b93a-be49e8c41e40", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-5d3b10cb-9c60-436d-b93a-be49e8c41e40" }, { "name": "fetch-connection-diff-status", "item": [ { "name": "{connection_identifier}", "item": [ { "name": "fetch Connection Diff Status", "id": "acf8a527-fe84-4db4-9370-5d2bbd8235eb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/fetch-connection-diff-status/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "fetch-connection-diff-status", ":connection_identifier" ], "variable": [ { "id": "8bb0aa80-26de-4182-9015-f24c0bf13c67", "key": "connection_identifier", "value": "", "description": "(Required) GUID of the connection" } ] }, "description": "\n Version: 9.9.0.cl or later\n\nValidates the difference in connection metadata between CDW and ThoughtSpot.\n\nRequires `DATAMANAGEMENT` (**Can manage data**) privilege.\nIf [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance, the following Data control privileges may be required:\n\n- `CAN_MANAGE_CUSTOM_CALENDAR`(**Can manage custom calendars**)\n- `CAN_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**)\n- `CAN_MANAGE_WORKSHEET_VIEWS_TABLES` (**Can manage data models**)\n\nReturns a boolean indicating whether there is any difference between the connection metadata at ThoughtSpot and CDW.\n\nTo get the connection metadata difference status, pass the connection GUID as `connection_identifier` in the API request.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "a69e0fd3-de7e-4fe5-afd3-39a7fdac719d", "name": "true/false", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/fetch-connection-diff-status/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "fetch-connection-diff-status", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"\"\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-a69e0fd3-de7e-4fe5-afd3-39a7fdac719d" }, { "id": "c3ae90a8-a314-482f-8243-30f48a1dbdee", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/fetch-connection-diff-status/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "fetch-connection-diff-status", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-c3ae90a8-a314-482f-8243-30f48a1dbdee" }, { "id": "07c5151c-5d72-4d22-aa7e-7666f0446fbd", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/fetch-connection-diff-status/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "fetch-connection-diff-status", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-07c5151c-5d72-4d22-aa7e-7666f0446fbd" }, { "id": "08b0911a-5d2c-4c3c-b514-39a71daff3b4", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/fetch-connection-diff-status/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "fetch-connection-diff-status", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-08b0911a-5d2c-4c3c-b514-39a71daff3b4" }, { "id": "e76e3e91-458a-464c-af55-c229e4719c88", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/connections/fetch-connection-diff-status/:connection_identifier", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "connections", "fetch-connection-diff-status", ":connection_identifier" ], "variable": [ { "key": "connection_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-e76e3e91-458a-464c-af55-c229e4719c88" } ], "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-acf8a527-fe84-4db4-9370-5d2bbd8235eb" } ], "id": "e631efcd-f585-4019-b7ee-7768ea038680", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-e631efcd-f585-4019-b7ee-7768ea038680" } ], "id": "986f7573-776f-4d5c-b5af-e763c940a837", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-986f7573-776f-4d5c-b5af-e763c940a837" } ], "id": "735a6c15-a50e-4481-b8e4-6bb84499beb3", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-735a6c15-a50e-4481-b8e4-6bb84499beb3" } ], "id": "35e9ae8b-3f0c-4ff9-a137-2c8a14bbb34c", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-35e9ae8b-3f0c-4ff9-a137-2c8a14bbb34c" } ], "id": "6942f658-7662-4506-a3be-f536553f142c", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-6942f658-7662-4506-a3be-f536553f142c" } ], "id": "ecb6ba32-808d-46bc-b2aa-90700030a6e8", "createdAt": "2026-07-28T03:15:46.000Z", "updatedAt": "2026-07-28T03:15:46.000Z", "uid": "35240-ecb6ba32-808d-46bc-b2aa-90700030a6e8" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "base-url", "value": "https://localhost:443" }, { "key": "baseUrl", "value": "{{base-url}}" } ] }