{ "info": { "_postman_id": "d0818175-2f9f-49d4-b3b6-c154ba8972ce", "name": "ThoughtSpot Public REST 10.1.0.cl Metadata API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:16:08.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "lastUpdatedBy": "35240", "uid": "35240-d0818175-2f9f-49d4-b3b6-c154ba8972ce" }, "item": [ { "name": "api", "item": [ { "name": "rest", "item": [ { "name": "2.0", "item": [ { "name": "metadata", "item": [ { "name": "worksheets", "item": [ { "name": "convert", "item": [ { "name": "convert Worksheet To Model", "id": "5a8419ba-a731-4581-8556-8c2c6efbb4f7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"exclude_worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"convert_all\": false,\n \"apply_changes\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/worksheets/convert", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "worksheets", "convert" ] }, "description": "\nConvert worksheets to models
Version: 10.6.0.cl or later\n\n## Prerequisites\n- **Privileges Required:**\n - `DATAMANAGEMENT` (Can manage data) or `ADMINISTRATION` (Can administer ThoughtSpot).\n- **Additional Privileges (if RBAC is enabled):**\n - `CAN_MANAGE_WORKSHEET_VIEWS_TABLES` (Can manage data models).\n\n---\n\n## Usage Guidelines\n\n### Parameters\n\n1. **worksheet_ids** \n - **Description:** A comma-separated list of GUIDs (Globally Unique Identifiers) specifying the Worksheets to be converted. \n - **Usage:** \n - Used only when `convert_all` is set to `false`. \n - Leave empty or omit when `convert_all` is set to `true`.\n\n2. **exclude_worksheet_ids** \n - **Description:** A comma-separated list of GUIDs specifying Worksheets to be excluded from conversion. \n - **Usage:** \n - Useful when `convert_all` is set to `true` and specific Worksheets should not be converted.\n\n3. **convert_all** \n - **Description:** Sets the scope of conversion.\n - **Options:** \n - `true`: Converts all Worksheets in the system, except those specified in `exclude_worksheet_ids`. \n - `false`: Converts only the Worksheets listed in `worksheet_ids`.\n\n4. **apply_changes** \n - **Description:** Specifies whether to apply changes directly to ThoughtSpot or to generate a preview before applying any changes.Used for validation of conversion.\n - **Options:** \n - `true`: Applies conversion changes directly to ThoughtSpot.\n - `false`: Generates only a preview of the changes and does not apply any changes to ThoughtSpot\n\n---\n\n## Best Practices\n\n1. **Backup Before Conversion:** \n Always export metadata as a backup before initiating the conversion process\n\n2. **Partial Conversion for Testing:** \n Test the conversion process by setting `convert_all` to `false` and specifying a small number of `worksheet_ids`.\n\n3. **Verify Dependencies:** \n Check for dependent objects, such as Tables and Connections, to avoid invalid references.\n\n4. **Review Changes:** \n Use `apply_changes: false` to preview the impact of the conversion before applying changes.\n\n---\n\n## Examples\n\n### Convert Specific Worksheets\n```json\n{\n \"worksheet_ids\": [\"guid1\", \"guid2\", \"guid3\"],\n \"exclude_worksheet_ids\": [],\n \"convert_all\": false,\n \"apply_changes\": true\n}\n```\n\n### Convert All Accessible Worksheets\n```json\n{\n \"worksheet_ids\": [],\n \"exclude_worksheet_ids\": [],\n \"convert_all\": true,\n \"apply_changes\": true\n}\n```\n\n### Exclude Specific Worksheets While Converting All Accessible Worksheets\n```json\n{\n \"worksheet_ids\": [],\n \"exclude_worksheet_ids\": [\"abc\"],\n \"convert_all\": true,\n \"apply_changes\": true\n}\n```\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "94c1a0d7-c3ea-4491-a04e-7c5f7a0500df", "name": "Conversion of worksheets to model done 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 \"worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"exclude_worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"convert_all\": false,\n \"apply_changes\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/worksheets/convert", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "worksheets", "convert" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"name\": \"\",\n \"success_count\": \"\",\n \"failure_count\": \"\",\n \"incomplete_count\": \"\",\n \"post_upgrade_failed_count\": \"\",\n \"total_time_in_millis\": \"\",\n \"successful_entities\": {\n \"data\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n },\n \"failed_entities\": {\n \"data\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"error\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"error\": \"\"\n }\n ]\n },\n \"incomplete_entities\": {\n \"data\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"error\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"error\": \"\"\n }\n ]\n },\n \"post_upgrade_failed_entities\": {\n \"data\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"error\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"error\": \"\"\n }\n ]\n }\n}", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-94c1a0d7-c3ea-4491-a04e-7c5f7a0500df" }, { "id": "9bd04842-e575-4fff-828b-84ce8f83e3da", "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 \"worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"exclude_worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"convert_all\": false,\n \"apply_changes\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/worksheets/convert", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "worksheets", "convert" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-9bd04842-e575-4fff-828b-84ce8f83e3da" }, { "id": "cbb3161b-9acb-4c95-ad56-17b0a1228b8b", "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 \"worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"exclude_worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"convert_all\": false,\n \"apply_changes\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/worksheets/convert", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "worksheets", "convert" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-cbb3161b-9acb-4c95-ad56-17b0a1228b8b" }, { "id": "0fc5d42b-22ea-4fe4-be8a-1261890ff7b5", "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 \"worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"exclude_worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"convert_all\": false,\n \"apply_changes\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/worksheets/convert", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "worksheets", "convert" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-0fc5d42b-22ea-4fe4-be8a-1261890ff7b5" }, { "id": "e6cf8e71-db36-40c8-8b86-48f9335ea19f", "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 \"worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"exclude_worksheet_ids\": [\n \"\",\n \"\"\n ],\n \"convert_all\": false,\n \"apply_changes\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/worksheets/convert", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "worksheets", "convert" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-e6cf8e71-db36-40c8-8b86-48f9335ea19f" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-5a8419ba-a731-4581-8556-8c2c6efbb4f7" } ], "id": "6db357e0-691a-474b-b610-9784bff23c13", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-6db357e0-691a-474b-b610-9784bff23c13" } ], "id": "65d06691-6ff1-44eb-9a84-567963e09d58", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-65d06691-6ff1-44eb-9a84-567963e09d58" }, { "name": "copyobject", "item": [ { "name": "copy Object", "id": "b60ad8e1-a987-42f2-8b33-ffe18748b4fb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"identifier\": \"\",\n \"description\": \"\",\n \"type\": \"LIVEBOARD\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/copyobject", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "copyobject" ] }, "description": "\nMakes a copy of an Answer or Liveboard
Version: 10.3.0.cl or later\n\nCreates a copy of a metadata object.\n\nRequires at least view access to the metadata object being copied.\n\nUpon successful execution, the API creates a copy of the metadata object specified in the API request and returns the ID of the new object.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "3810f6e3-690f-4a52-b6ba-b335b50b9c6e", "name": "Successfully created a copy of the object", "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 \"identifier\": \"\",\n \"description\": \"\",\n \"type\": \"LIVEBOARD\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/copyobject", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "copyobject" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"metadata_id\": \"\"\n}", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-3810f6e3-690f-4a52-b6ba-b335b50b9c6e" }, { "id": "7e1ddab5-3c4d-42cf-8324-30a8e9e776d0", "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 \"identifier\": \"\",\n \"description\": \"\",\n \"type\": \"LIVEBOARD\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/copyobject", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "copyobject" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-7e1ddab5-3c4d-42cf-8324-30a8e9e776d0" }, { "id": "7f992772-16b3-4a66-a3ff-9f2bcc28aa34", "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 \"identifier\": \"\",\n \"description\": \"\",\n \"type\": \"LIVEBOARD\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/copyobject", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "copyobject" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-7f992772-16b3-4a66-a3ff-9f2bcc28aa34" }, { "id": "9059ae07-81f5-4238-93d4-37fedb7d800c", "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 \"identifier\": \"\",\n \"description\": \"\",\n \"type\": \"LIVEBOARD\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/copyobject", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "copyobject" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-9059ae07-81f5-4238-93d4-37fedb7d800c" }, { "id": "b13f159a-abc7-4a18-a3e8-b7a7dce43e2c", "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 \"identifier\": \"\",\n \"description\": \"\",\n \"type\": \"LIVEBOARD\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/copyobject", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "copyobject" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-b13f159a-abc7-4a18-a3e8-b7a7dce43e2c" }, { "id": "8a991555-fbe3-4b42-9d02-4c69949654e7", "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 \"identifier\": \"\",\n \"description\": \"\",\n \"type\": \"LIVEBOARD\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/copyobject", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "copyobject" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-8a991555-fbe3-4b42-9d02-4c69949654e7" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-b60ad8e1-a987-42f2-8b33-ffe18748b4fb" } ], "id": "b8903dd4-d1a3-44ab-ac1c-c1e27b058184", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-b8903dd4-d1a3-44ab-ac1c-c1e27b058184" }, { "name": "delete", "item": [ { "name": "delete Metadata", "id": "1401dded-8cca-43ad-a084-012b22aa985a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata\": [\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n }\n ],\n \"delete_disabled_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "delete" ] }, "description": "\n Version: 9.0.0.cl or later\n\nRemoves the specified metadata object from the ThoughtSpot system.\n\nRequires edit access to the metadata object. \n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "7ee5d02c-c56f-4793-bee5-638e2c2ed89b", "name": "Metadata objects 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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n }\n ],\n \"delete_disabled_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "delete" ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-7ee5d02c-c56f-4793-bee5-638e2c2ed89b" }, { "id": "2fadbe39-b0a7-4eb9-95ad-1b2cd46d8551", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n }\n ],\n \"delete_disabled_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-2fadbe39-b0a7-4eb9-95ad-1b2cd46d8551" }, { "id": "3cfa2e87-d11a-4f15-b9e2-47af594b2594", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n }\n ],\n \"delete_disabled_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-3cfa2e87-d11a-4f15-b9e2-47af594b2594" }, { "id": "883858fd-8480-4f58-8cc6-73e90ff3131e", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n }\n ],\n \"delete_disabled_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-883858fd-8480-4f58-8cc6-73e90ff3131e" }, { "id": "da013f0f-63e9-43c9-afdc-44bb0d899e03", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"LIVEBOARD\"\n }\n ],\n \"delete_disabled_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-da013f0f-63e9-43c9-afdc-44bb0d899e03" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-1401dded-8cca-43ad-a084-012b22aa985a" } ], "id": "8576802f-f2e2-45f0-9e75-c96a7d99cbe5", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-8576802f-f2e2-45f0-9e75-c96a7d99cbe5" }, { "name": "tml", "item": [ { "name": "export", "item": [ { "name": "batch", "item": [ { "name": "export Metadata TML Batched", "id": "48d5970d-3c2e-4491-887a-acfd287196fe", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata_type\": \"ROLE\",\n \"batch_offset\": 0,\n \"batch_size\": 20,\n \"edoc_format\": \"JSON\",\n \"export_dependent\": false,\n \"all_orgs_override\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export", "batch" ] }, "description": "\n Version: 10.1.0.cl or later\n\nExports the [TML](https://docs.thoughtspot.com/cloud/latest/tml) representation of metadata objects in JSON or YAML format.\n\n### **Permissions Required**\n\nRequires `DATAMANAGEMENT` (**Can manage data**) and `USERMANAGEMENT` (**Can manage users**) privileges.\n\n#### **Usage Guidelines**\n\nThis API is only applicable for `USER`, `GROUP`, and `ROLES` metadata types.\n\n- `batch_offset` Indicates the starting position within the complete dataset from which the API should begin returning objects. Useful for paginating results efficiently.\n- `batch_size` Specifies the number of objects or items to retrieve in a single request. Helps control response size for better performance.\n- `edoc_format` Defines the format of the TML content. The exported metadata can be in JSON or YAML format.\n- `export_dependent` Specifies whether to include dependent metadata objects in the export. Ensures related objects are also retrieved if needed.\n- `all_orgs_override` Indicates whether the export operation applies across all organizations. Useful for multi-tenant environments where cross-org exports are required.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "2c82a50c-fe41-43b2-9dc8-c84a57cb40f2", "name": "Export TMLs of specified metadata objects is successful.", "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 \"metadata_type\": \"ROLE\",\n \"batch_offset\": 0,\n \"batch_size\": 20,\n \"edoc_format\": \"JSON\",\n \"export_dependent\": false,\n \"all_orgs_override\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export", "batch" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-2c82a50c-fe41-43b2-9dc8-c84a57cb40f2" }, { "id": "d7b07355-35e0-4fb4-b24c-a02ca7d76f16", "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 \"metadata_type\": \"ROLE\",\n \"batch_offset\": 0,\n \"batch_size\": 20,\n \"edoc_format\": \"JSON\",\n \"export_dependent\": false,\n \"all_orgs_override\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export", "batch" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-d7b07355-35e0-4fb4-b24c-a02ca7d76f16" }, { "id": "58f0b20f-9282-4d66-99a3-aed577db97a7", "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 \"metadata_type\": \"ROLE\",\n \"batch_offset\": 0,\n \"batch_size\": 20,\n \"edoc_format\": \"JSON\",\n \"export_dependent\": false,\n \"all_orgs_override\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export", "batch" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-58f0b20f-9282-4d66-99a3-aed577db97a7" }, { "id": "b7c8a9cd-497e-4a33-848d-0573182cae1d", "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 \"metadata_type\": \"ROLE\",\n \"batch_offset\": 0,\n \"batch_size\": 20,\n \"edoc_format\": \"JSON\",\n \"export_dependent\": false,\n \"all_orgs_override\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export", "batch" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-b7c8a9cd-497e-4a33-848d-0573182cae1d" }, { "id": "4642fbc2-a561-4201-bf9f-12b17f38344a", "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 \"metadata_type\": \"ROLE\",\n \"batch_offset\": 0,\n \"batch_size\": 20,\n \"edoc_format\": \"JSON\",\n \"export_dependent\": false,\n \"all_orgs_override\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export", "batch" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-4642fbc2-a561-4201-bf9f-12b17f38344a" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-48d5970d-3c2e-4491-887a-acfd287196fe" } ], "id": "4dc1dd49-fd65-413f-8dd6-6579856fb998", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-4dc1dd49-fd65-413f-8dd6-6579856fb998" }, { "name": "export Metadata TML", "id": "9ef46740-4c68-4c12-ae79-0f4c56d282c5", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata\": [\n {\n \"type\": \"ANSWER\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n },\n {\n \"type\": \"USER_GROUP\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n }\n ],\n \"export_associated\": false,\n \"export_fqn\": false,\n \"edoc_format\": \"JSON\",\n \"export_schema_version\": \"DEFAULT\",\n \"export_dependent\": false,\n \"export_connection_as_dependent\": false,\n \"all_orgs_override\": false,\n \"export_options\": {\n \"include_obj_id_ref\": false,\n \"include_guid\": true,\n \"include_obj_id\": false,\n \"export_with_associated_feedbacks\": false,\n \"export_column_security_rules\": false,\n \"export_with_column_aliases\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export" ] }, "description": "\n Version: 9.0.0.cl or later\n\nExports the [TML](https://docs.thoughtspot.com/cloud/latest/tml) representation of metadata objects in JSON or YAML format.\n\nRequires `DATADOWNLOADING` (**Can download Data**) and at least view access to the metadata object.\n\n#### Usage guidelines\n\n* You can export one or several objects by passing metadata object GUIDs in the `metadata` array.\n* When exporting TML content for a Liveboard or Answer object, you can set `export_associated` to `true` to retrieve TML content for underlying Worksheets, Tables, or Views, including the GUID of each object within the headers. When `export_associated` is set to `true`, consider retrieving one metadata object at a time.\n* Set `export_fqns` to `true` to add FQNs of the referenced objects in the TML content. For example, if you send an API request to retrieve TML for a Liveboard and its associated objects, the API returns the TML content with FQNs of the referenced Worksheet. Exporting TML with FQNs is useful if ThoughtSpot has multiple objects with the same name and you want to eliminate ambiguity when importing TML files into ThoughtSpot. It eliminates the need for adding FQNs of the referenced objects manually during the import operation.\n* To export only the TML of feedbacks associated with an object, set the GUID of the object as `identifier`, and set the `type` as `FEEDBACK` in the `metadata` array.\n* To export the TML of an object along with the feedbacks associated with it, set the GUID of the object as `identifier`, set the `type` as `LOGIAL_TABLE` in the `metadata` array, and set `export_with_associated_feedbacks` in `export_options` to true.\n\nFor more information, see [TML Documentation](https://developers.thoughtspot.com/docs/tml#_export_a_tml).\n\nFor more information on feedbacks, see [Feedback Documentation](https://docs.thoughtspot.com/cloud/latest/sage-feedback).\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "d7e1b8f1-c18c-46de-a996-6218408b1f14", "name": "Export TMLs of specified metadata objects is successful.", "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 \"metadata\": [\n {\n \"type\": \"ANSWER\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n },\n {\n \"type\": \"USER_GROUP\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n }\n ],\n \"export_associated\": false,\n \"export_fqn\": false,\n \"edoc_format\": \"JSON\",\n \"export_schema_version\": \"DEFAULT\",\n \"export_dependent\": false,\n \"export_connection_as_dependent\": false,\n \"all_orgs_override\": false,\n \"export_options\": {\n \"include_obj_id_ref\": false,\n \"include_guid\": true,\n \"include_obj_id\": false,\n \"export_with_associated_feedbacks\": false,\n \"export_column_security_rules\": false,\n \"export_with_column_aliases\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[]", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-d7e1b8f1-c18c-46de-a996-6218408b1f14" }, { "id": "a56d9bbf-a55b-4af4-bd02-daac55a77e9d", "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 \"metadata\": [\n {\n \"type\": \"ANSWER\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n },\n {\n \"type\": \"USER_GROUP\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n }\n ],\n \"export_associated\": false,\n \"export_fqn\": false,\n \"edoc_format\": \"JSON\",\n \"export_schema_version\": \"DEFAULT\",\n \"export_dependent\": false,\n \"export_connection_as_dependent\": false,\n \"all_orgs_override\": false,\n \"export_options\": {\n \"include_obj_id_ref\": false,\n \"include_guid\": true,\n \"include_obj_id\": false,\n \"export_with_associated_feedbacks\": false,\n \"export_column_security_rules\": false,\n \"export_with_column_aliases\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-a56d9bbf-a55b-4af4-bd02-daac55a77e9d" }, { "id": "af501015-29f4-4bcc-8f7f-861ef9ca9d22", "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 \"metadata\": [\n {\n \"type\": \"ANSWER\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n },\n {\n \"type\": \"USER_GROUP\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n }\n ],\n \"export_associated\": false,\n \"export_fqn\": false,\n \"edoc_format\": \"JSON\",\n \"export_schema_version\": \"DEFAULT\",\n \"export_dependent\": false,\n \"export_connection_as_dependent\": false,\n \"all_orgs_override\": false,\n \"export_options\": {\n \"include_obj_id_ref\": false,\n \"include_guid\": true,\n \"include_obj_id\": false,\n \"export_with_associated_feedbacks\": false,\n \"export_column_security_rules\": false,\n \"export_with_column_aliases\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-af501015-29f4-4bcc-8f7f-861ef9ca9d22" }, { "id": "1141858b-d205-41f8-af09-56cf86d57264", "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 \"metadata\": [\n {\n \"type\": \"ANSWER\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n },\n {\n \"type\": \"USER_GROUP\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n }\n ],\n \"export_associated\": false,\n \"export_fqn\": false,\n \"edoc_format\": \"JSON\",\n \"export_schema_version\": \"DEFAULT\",\n \"export_dependent\": false,\n \"export_connection_as_dependent\": false,\n \"all_orgs_override\": false,\n \"export_options\": {\n \"include_obj_id_ref\": false,\n \"include_guid\": true,\n \"include_obj_id\": false,\n \"export_with_associated_feedbacks\": false,\n \"export_column_security_rules\": false,\n \"export_with_column_aliases\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-1141858b-d205-41f8-af09-56cf86d57264" }, { "id": "d147c939-f6eb-408c-9ec3-c626d7b1486c", "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 \"metadata\": [\n {\n \"type\": \"ANSWER\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n },\n {\n \"type\": \"USER_GROUP\",\n \"identifier\": \"\",\n \"session_identifier\": \"\",\n \"generation_number\": \"\"\n }\n ],\n \"export_associated\": false,\n \"export_fqn\": false,\n \"edoc_format\": \"JSON\",\n \"export_schema_version\": \"DEFAULT\",\n \"export_dependent\": false,\n \"export_connection_as_dependent\": false,\n \"all_orgs_override\": false,\n \"export_options\": {\n \"include_obj_id_ref\": false,\n \"include_guid\": true,\n \"include_obj_id\": false,\n \"export_with_associated_feedbacks\": false,\n \"export_column_security_rules\": false,\n \"export_with_column_aliases\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "export" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-d147c939-f6eb-408c-9ec3-c626d7b1486c" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-9ef46740-4c68-4c12-ae79-0f4c56d282c5" } ], "id": "0bb5c98d-de63-4e67-b075-57c62ee0b3ed", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-0bb5c98d-de63-4e67-b075-57c62ee0b3ed" }, { "name": "async", "item": [ { "name": "status", "item": [ { "name": "fetch Async Import Task Status", "id": "d6e65697-3dde-42b8-814d-11061b321f4f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"task_ids\": [\n \"\",\n \"\"\n ],\n \"task_status\": [\n \"IN_PROGRESS\",\n \"IN_QUEUE\"\n ],\n \"author_identifier\": \"\",\n \"record_offset\": 0,\n \"record_size\": 5,\n \"include_import_response\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "status" ] }, "description": "\n Version: 10.4.0.cl or later\n\nGets information about the status of the TML async import task scheduled using the `/api/rest/2.0/metadata/tml/async/import` API call.\n\nTo fetch the task details, specify the ID of the TML async import task. \n\nRequires access to the task ID. The API allows users who initiated the asynchronous TML import via `/api/rest/2.0/metadata/tml/async/import` to view the status of their tasks. Users with administration privilege can view the status of all import tasks initiated by the users in their Org.\n\n#### Usage guidelines\n\nSee [TML API Documentation](https://developers.thoughtspot.com/docs/tml#_fetch_status_of_the_tml_import_task) for usage guidelines.\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "56409039-7a8f-4da4-9900-4e133edda393", "name": "Async TML Import Task statuses fetched 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 \"task_ids\": [\n \"\",\n \"\"\n ],\n \"task_status\": [\n \"IN_PROGRESS\",\n \"IN_QUEUE\"\n ],\n \"author_identifier\": \"\",\n \"record_offset\": 0,\n \"record_size\": 5,\n \"include_import_response\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "status" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status_list\": [\n {\n \"tenant_id\": \"\",\n \"org_id\": \"\",\n \"task_id\": \"\",\n \"task_name\": \"\",\n \"import_response\": {},\n \"task_status\": \"FAILED\",\n \"author_id\": \"\",\n \"import_policy\": \"VALIDATE_ONLY\",\n \"created_at\": \"\",\n \"in_progress_at\": \"\",\n \"completed_at\": \"\",\n \"total_object_count\": \"\",\n \"object_processed_count\": \"\",\n \"modified_at\": \"\",\n \"author_display_name\": \"\"\n },\n {\n \"tenant_id\": \"\",\n \"org_id\": \"\",\n \"task_id\": \"\",\n \"task_name\": \"\",\n \"import_response\": {},\n \"task_status\": \"COMPLETED\",\n \"author_id\": \"\",\n \"import_policy\": \"PARTIAL_OBJECT\",\n \"created_at\": \"\",\n \"in_progress_at\": \"\",\n \"completed_at\": \"\",\n \"total_object_count\": \"\",\n \"object_processed_count\": \"\",\n \"modified_at\": \"\",\n \"author_display_name\": \"\"\n }\n ],\n \"last_batch\": \"\"\n}", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-56409039-7a8f-4da4-9900-4e133edda393" }, { "id": "c1941483-d478-4795-9a80-b18fbfa81e9a", "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 \"task_ids\": [\n \"\",\n \"\"\n ],\n \"task_status\": [\n \"IN_PROGRESS\",\n \"IN_QUEUE\"\n ],\n \"author_identifier\": \"\",\n \"record_offset\": 0,\n \"record_size\": 5,\n \"include_import_response\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "status" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-c1941483-d478-4795-9a80-b18fbfa81e9a" }, { "id": "7e0f5b93-279b-4b22-939c-4137fbe4b2e7", "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 \"task_ids\": [\n \"\",\n \"\"\n ],\n \"task_status\": [\n \"IN_PROGRESS\",\n \"IN_QUEUE\"\n ],\n \"author_identifier\": \"\",\n \"record_offset\": 0,\n \"record_size\": 5,\n \"include_import_response\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "status" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-7e0f5b93-279b-4b22-939c-4137fbe4b2e7" }, { "id": "cb3431d2-7f73-483f-9feb-a90646a77828", "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 \"task_ids\": [\n \"\",\n \"\"\n ],\n \"task_status\": [\n \"IN_PROGRESS\",\n \"IN_QUEUE\"\n ],\n \"author_identifier\": \"\",\n \"record_offset\": 0,\n \"record_size\": 5,\n \"include_import_response\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "status" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-cb3431d2-7f73-483f-9feb-a90646a77828" }, { "id": "276da0ac-24e1-4efb-b141-82590edc76ac", "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 \"task_ids\": [\n \"\",\n \"\"\n ],\n \"task_status\": [\n \"IN_PROGRESS\",\n \"IN_QUEUE\"\n ],\n \"author_identifier\": \"\",\n \"record_offset\": 0,\n \"record_size\": 5,\n \"include_import_response\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "status" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-276da0ac-24e1-4efb-b141-82590edc76ac" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-d6e65697-3dde-42b8-814d-11061b321f4f" } ], "id": "f30f07a7-69b3-4dcc-99ab-5d556ce68d2e", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-f30f07a7-69b3-4dcc-99ab-5d556ce68d2e" }, { "name": "import", "item": [ { "name": "import Metadata TML Async", "id": "64087302-54ee-4fdf-a916-9ce87d4d3e4b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"import_policy\": \"PARTIAL_OBJECT\",\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "import" ] }, "description": "\n Version: 10.4.0.cl or later\n\nSchedules a task to import [TML](https://docs.thoughtspot.com/cloud/latest/tml) files into ThoughtSpot. You can use this API endpoint to process TML objects asynchronously when importing TMLs of large and complex metadata objects into ThoughtSpot. Unlike the synchronous import TML operation, the API processes TML data in the background and returns a task ID, which can be used to check the status of the import task via `/api/rest/2.0/metadata/tml/async/status` API endpoint.\n\nRequires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can administer ThoughtsSpot**) privilege, and edit access to the TML objects.\n\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_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**)\n- `CAN_MANAGE_WORKSHEET_VIEWS_TABLES` (**Can manage data models**)\n\n#### Usage guidelines\n\nSee [Async TML API Documentation](https://developers.thoughtspot.com/docs/tml#_import_tml_objects_asynchronously) for usage guidelines.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "bcb177d6-f662-4516-b966-cd46a5ece03a", "name": "Async TML Import Task submitted 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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"import_policy\": \"PARTIAL_OBJECT\",\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "import" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"tenant_id\": \"\",\n \"org_id\": \"\",\n \"task_id\": \"\",\n \"task_name\": \"\",\n \"import_response\": {},\n \"task_status\": \"FAILED\",\n \"author_id\": \"\",\n \"import_policy\": \"VALIDATE_ONLY\",\n \"created_at\": \"\",\n \"in_progress_at\": \"\",\n \"completed_at\": \"\",\n \"total_object_count\": \"\",\n \"object_processed_count\": \"\",\n \"modified_at\": \"\",\n \"author_display_name\": \"\"\n}", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-bcb177d6-f662-4516-b966-cd46a5ece03a" }, { "id": "ecf5e5c7-5bc9-4227-92a6-7e1a67959c34", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"import_policy\": \"PARTIAL_OBJECT\",\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "import" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-ecf5e5c7-5bc9-4227-92a6-7e1a67959c34" }, { "id": "8f223cd8-29c1-4ede-8099-df0256c98775", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"import_policy\": \"PARTIAL_OBJECT\",\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "import" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-8f223cd8-29c1-4ede-8099-df0256c98775" }, { "id": "0aec7af2-963e-431f-843b-6cab54f5608f", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"import_policy\": \"PARTIAL_OBJECT\",\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "import" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-0aec7af2-963e-431f-843b-6cab54f5608f" }, { "id": "a6ab8440-c462-415a-8cfe-310d2dd2634a", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"import_policy\": \"PARTIAL_OBJECT\",\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/async/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "async", "import" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-a6ab8440-c462-415a-8cfe-310d2dd2634a" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-64087302-54ee-4fdf-a916-9ce87d4d3e4b" } ], "id": "21013c70-d52a-4f48-abb2-8b3e7b636845", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-21013c70-d52a-4f48-abb2-8b3e7b636845" } ], "id": "8de3bdc9-fa19-4aa2-8ff3-4e0fe9633e0b", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-8de3bdc9-fa19-4aa2-8ff3-4e0fe9633e0b" }, { "name": "import", "item": [ { "name": "import Metadata TML", "id": "98c37d16-5a16-4c17-b957-7a90f365aeb3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"import_policy\": \"PARTIAL\",\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "import" ] }, "description": "\n Version: 9.0.0.cl or later\n\nImports [TML](https://docs.thoughtspot.com/cloud/latest/tml) files into ThoughtSpot.\n\nRequires `DATAMANAGEMENT` (**Can manage data**) or `ADMINISTRATION` (**Can administer ThoughtsSpot**) privilege.\n\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_CREATE_OR_EDIT_CONNECTIONS` (**Can create/edit Connections**)\n- `CAN_MANAGE_WORKSHEET_VIEWS_TABLES` (**Can manage data models**)\n\n#### Usage guidelines\n\n* Import all related objects in a single TML Import API call. For example, Tables that use the same Connection object and Worksheets connected to these Tables.\n* Include the `fqn` property to distinguish objects that have the same name.\n For example, if you have multiple Connections or Worksheets with the same name on ThoughtSpot and the Connection or Worksheet referenced in your TML file does not have a unique name to distinguish, it may result in invalid object references.\n Adding `fqn` helps ThoughtSpot differentiate a Table from another with the same name.\n We recommend [exporting TML with FQNs](#/http/api-endpoints/metadata/export-metadata-tml) and using these during the import operation.\n* You can upload multiple TML files at a time.\n If you import a Worksheet along with Liveboards, Answers, and other dependent objects in a single API call, the imported objects will be immediately available for use.\n When you import only a Worksheet object, it may take some time for the Worksheet to become available in the ThoughtSpot system. Please wait for a few minutes, and then proceed to create an Answer and Liveboard from the newly imported Worksheet.\n\nFor more information, see [TML Documentation](https://developers.thoughtspot.com/docs/tml#_import_a_tml).\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "c5a43fbe-ca71-422c-bf92-79d076ecd33a", "name": "Import metadata objects using specified TMLs is successful.", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"import_policy\": \"PARTIAL\",\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "import" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[]", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-c5a43fbe-ca71-422c-bf92-79d076ecd33a" }, { "id": "37f37921-1dbd-420a-8ab0-30ce46989b76", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"import_policy\": \"PARTIAL\",\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "import" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-37f37921-1dbd-420a-8ab0-30ce46989b76" }, { "id": "b020ea8f-97eb-4a37-94ad-94e0a0ee5047", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"import_policy\": \"PARTIAL\",\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "import" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-b020ea8f-97eb-4a37-94ad-94e0a0ee5047" }, { "id": "269a2f7e-ef5e-4dee-9d3c-04b95342b800", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"import_policy\": \"PARTIAL\",\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "import" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-269a2f7e-ef5e-4dee-9d3c-04b95342b800" }, { "id": "7b0feeff-e9e6-4c68-a25a-1b9043958f0f", "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 \"metadata_tmls\": [\n \"\",\n \"\"\n ],\n \"import_policy\": \"PARTIAL\",\n \"create_new\": false,\n \"all_orgs_override\": false,\n \"skip_diff_check\": false,\n \"enable_large_metadata_validation\": false,\n \"enable_personalized_view_upsert\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/tml/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "tml", "import" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-7b0feeff-e9e6-4c68-a25a-1b9043958f0f" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-98c37d16-5a16-4c17-b957-7a90f365aeb3" } ], "id": "cd219744-4a61-40b8-943c-cf1b223ef769", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-cd219744-4a61-40b8-943c-cf1b223ef769" } ], "id": "f7fe3f4b-f9a8-4dae-a54a-a68dc6859e9f", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-f7fe3f4b-f9a8-4dae-a54a-a68dc6859e9f" }, { "name": "answer", "item": [ { "name": "sql", "item": [ { "name": "fetch Answer Sql Query", "id": "d2af77e6-dfb7-4516-8c4e-fb4c86a0522c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/answer/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "answer", "sql" ] }, "description": "\n Version: 9.0.0.cl or later\n\nFetches the underlying SQL query data for an Answer object.\n\nRequires at least view access to the Answer object.\n\nUpon successful execution, the API returns the SQL queries for the specified object as shown in this example:\n```\n{\n \"metadata_id\":\"8fbe44a8-46ad-4b16-8d39-184b2fada490\",\n \"metadata_name\":\"Total sales\",\n \"metadata_type\":\"ANSWER\",\n \"sql_queries\":[\n {\n \"metadata_id\":\"8fbe44a8-46ad-4b16-8d39-184b2fada490\",\n \"metadata_name\":\"Total sales -test\",\n \"sql_query\":\"SELECT \\n \\\"ta_1\\\".\\\"REGION\\\" \\\"ca_1\\\", \\n \\\"ta_2\\\".\\\"PRODUCTNAME\\\" \\\"ca_2\\\", \\n \\\"ta_1\\\".\\\"STORENAME\\\" \\\"ca_3\\\", \\n CASE\\n WHEN sum(\\\"ta_3\\\".\\\"SALES\\\") IS NOT NULL THEN sum(\\\"ta_3\\\".\\\"SALES\\\")\\n ELSE 0\\n END \\\"ca_4\\\", \\n CASE\\n WHEN sum(\\\"ta_3\\\".\\\"QUANTITYPURCHASED\\\") IS NOT NULL THEN sum(\\\"ta_3\\\".\\\"QUANTITYPURCHASED\\\")\\n ELSE 0\\n END \\\"ca_5\\\"\\nFROM \\\"RETAILAPPAREL\\\".\\\"PUBLIC\\\".\\\"FACT_RETAPP_SALES\\\" \\\"ta_3\\\"\\n JOIN \\\"RETAILAPPAREL\\\".\\\"PUBLIC\\\".\\\"DIM_RETAPP_STORES\\\" \\\"ta_1\\\"\\n ON \\\"ta_3\\\".\\\"STOREID\\\" = \\\"ta_1\\\".\\\"STOREID\\\"\\n JOIN \\\"RETAILAPPAREL\\\".\\\"PUBLIC\\\".\\\"DIM_RETAPP_PRODUCTS\\\" \\\"ta_2\\\"\\n ON \\\"ta_3\\\".\\\"PRODUCTID\\\" = \\\"ta_2\\\".\\\"PRODUCTID\\\"\\nGROUP BY \\n \\\"ca_1\\\", \\n \\\"ca_2\\\", \\n \\\"ca_3\\\"\\n\"\n }\n ]\n}\n```\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "078f5ca6-3303-4eb2-a7ef-50eeb7c046f1", "name": "Fetching SQL query of specified metadata object is successful.", "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 \"metadata_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/answer/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "answer", "sql" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"metadata_id\": \"\",\n \"metadata_name\": \"\",\n \"metadata_type\": \"TAG\",\n \"sql_queries\": [\n {\n \"metadata_id\": \"\",\n \"metadata_name\": \"\",\n \"sql_query\": \"\"\n },\n {\n \"metadata_id\": \"\",\n \"metadata_name\": \"\",\n \"sql_query\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-078f5ca6-3303-4eb2-a7ef-50eeb7c046f1" }, { "id": "1713712d-b0ea-4cdf-bcdc-b5f87c15210e", "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 \"metadata_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/answer/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "answer", "sql" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-1713712d-b0ea-4cdf-bcdc-b5f87c15210e" }, { "id": "f42d0e64-0497-4c78-b289-d5d7159b5243", "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 \"metadata_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/answer/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "answer", "sql" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-f42d0e64-0497-4c78-b289-d5d7159b5243" }, { "id": "6ed80f16-86aa-4201-8f7a-73f449b6aadd", "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 \"metadata_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/answer/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "answer", "sql" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-6ed80f16-86aa-4201-8f7a-73f449b6aadd" }, { "id": "6df409d7-bd00-43c6-af4a-042c025f4ce7", "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 \"metadata_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/answer/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "answer", "sql" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-6df409d7-bd00-43c6-af4a-042c025f4ce7" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-d2af77e6-dfb7-4516-8c4e-fb4c86a0522c" } ], "id": "76e0c69f-938a-43e8-9de4-59d54fa1cebf", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-76e0c69f-938a-43e8-9de4-59d54fa1cebf" } ], "id": "d3cf7877-d959-42ad-ab54-6eb124cb238a", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-d3cf7877-d959-42ad-ab54-6eb124cb238a" }, { "name": "liveboard", "item": [ { "name": "sql", "item": [ { "name": "fetch Liveboard Sql Query", "id": "2e436c2d-d966-4895-9985-37c4544f286f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata_identifier\": \"\",\n \"visualization_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/liveboard/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "liveboard", "sql" ] }, "description": "\n Version: 9.0.0.cl or later\n\nFetches the underlying SQL query data for a Liveboard object and its visualizations.\n\nRequires at least view access to the Liveboard object.\n\nTo get SQL query data for a Liveboard, specify the GUID of the Liveboard. Optionally, you can add an array of visualization GUIDs to retrieve the SQL query data for visualizations in the Liveboard.\n\nUpon successful execution, the API returns the SQL queries for the specified object as shown in this example:\n```\n{\n \"metadata_id\": \"fa68ae91-7588-4136-bacd-d71fb12dda69\",\n \"metadata_name\": \"Total Sales\",\n \"metadata_type\": \"LIVEBOARD\",\n \"sql_queries\": [\n {\n \"metadata_id\": \"b3b6d2b9-089a-490c-8e16-b144650b7843\",\n \"metadata_name\": \"Total quantity purchased, Total sales by region\",\n \"sql_query\": \"SELECT \\n \\\"ta_1\\\".\\\"REGION\\\" \\\"ca_1\\\", \\n CASE\\n WHEN sum(\\\"ta_2\\\".\\\"QUANTITYPURCHASED\\\") IS NOT NULL THEN sum(\\\"ta_2\\\".\\\"QUANTITYPURCHASED\\\")\\n ELSE 0\\n END \\\"ca_2\\\", \\n CASE\\n WHEN sum(\\\"ta_2\\\".\\\"SALES\\\") IS NOT NULL THEN sum(\\\"ta_2\\\".\\\"SALES\\\")\\n ELSE 0\\n END \\\"ca_3\\\"\\nFROM \\\"RETAILAPPAREL\\\".\\\"PUBLIC\\\".\\\"FACT_RETAPP_SALES\\\" \\\"ta_2\\\"\\n JOIN \\\"RETAILAPPAREL\\\".\\\"PUBLIC\\\".\\\"DIM_RETAPP_STORES\\\" \\\"ta_1\\\"\\n ON \\\"ta_2\\\".\\\"STOREID\\\" = \\\"ta_1\\\".\\\"STOREID\\\"\\nGROUP BY \\\"ca_1\\\"\"\n }\n ]\n}\n```\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "b24a31eb-1c44-42d4-9e48-09d3dac4c6ec", "name": "Fetching SQL query of specified metadata object is successful.", "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 \"metadata_identifier\": \"\",\n \"visualization_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/liveboard/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "liveboard", "sql" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"metadata_id\": \"\",\n \"metadata_name\": \"\",\n \"metadata_type\": \"TAG\",\n \"sql_queries\": [\n {\n \"metadata_id\": \"\",\n \"metadata_name\": \"\",\n \"sql_query\": \"\"\n },\n {\n \"metadata_id\": \"\",\n \"metadata_name\": \"\",\n \"sql_query\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-b24a31eb-1c44-42d4-9e48-09d3dac4c6ec" }, { "id": "02c57386-1665-4f27-a507-a1b9cdc65149", "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 \"metadata_identifier\": \"\",\n \"visualization_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/liveboard/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "liveboard", "sql" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-02c57386-1665-4f27-a507-a1b9cdc65149" }, { "id": "f1306bd1-37be-4436-8c6e-7e3eb351a182", "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 \"metadata_identifier\": \"\",\n \"visualization_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/liveboard/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "liveboard", "sql" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-f1306bd1-37be-4436-8c6e-7e3eb351a182" }, { "id": "6faae8cc-9595-4278-bafa-6d9119057f9f", "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 \"metadata_identifier\": \"\",\n \"visualization_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/liveboard/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "liveboard", "sql" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-6faae8cc-9595-4278-bafa-6d9119057f9f" }, { "id": "77cfe51b-66eb-4139-ab6d-ac175b65df79", "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 \"metadata_identifier\": \"\",\n \"visualization_identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/liveboard/sql", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "liveboard", "sql" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-77cfe51b-66eb-4139-ab6d-ac175b65df79" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-2e436c2d-d966-4895-9985-37c4544f286f" } ], "id": "09bc24bf-bbd2-4ea7-8731-19bd18b0b88c", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-09bc24bf-bbd2-4ea7-8731-19bd18b0b88c" } ], "id": "c65acf69-8105-4efc-af2f-445f244f302b", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-c65acf69-8105-4efc-af2f-445f244f302b" }, { "name": "parameterize", "item": [ { "name": "parameterize Metadata", "id": "0bba2807-3aa9-44e2-b100-11eaedd2d518", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_name\": \"\",\n \"variable_identifier\": \"\",\n \"metadata_type\": \"CONNECTION\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize" ] }, "description": "\nParameterize fields in metadata objects.
Beta Version: 10.9.0.cl or later\n\n**Note:** This API endpoint is deprecated and will be removed from ThoughtSpot in a future release. Use [POST /api/rest/2.0/metadata/parameterize-fields](/api/rest/2.0/metadata/parameterize-fields) instead.\n\nAllows parameterizing fields in metadata objects in ThoughtSpot.\n\nRequires appropriate permissions to modify the metadata object.\n\nThe API endpoint allows parameterizing the following types of metadata objects:\n* Logical Tables\n* Connections\n* Connection Configs\n\nFor a Logical Table the field type must be `ATTRIBUTE` and field name can be one of:\n* databaseName\n* schemaName\n* tableName\n\nFor a Connection or Connection Config, the field type is always `CONNECTION_PROPERTY`. In this case, field_name specifies the exact property of the Connection or Connection Config that needs to be parameterized.\n\nFor Connection Config, the only supported field name is:\n* impersonate_user\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "49ef4fb6-31f1-4f0c-99c6-f21588962b5f", "name": "Parameterize successful.", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_name\": \"\",\n \"variable_identifier\": \"\",\n \"metadata_type\": \"CONNECTION\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize" ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-49ef4fb6-31f1-4f0c-99c6-f21588962b5f" }, { "id": "65daf750-ed81-496d-b62c-895ab34d9448", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_name\": \"\",\n \"variable_identifier\": \"\",\n \"metadata_type\": \"CONNECTION\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-65daf750-ed81-496d-b62c-895ab34d9448" }, { "id": "f7383e65-1ba0-45d3-a33d-c63234f3d908", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_name\": \"\",\n \"variable_identifier\": \"\",\n \"metadata_type\": \"CONNECTION\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-f7383e65-1ba0-45d3-a33d-c63234f3d908" }, { "id": "3cb40db3-0403-449c-b5e5-a7ea306f8df6", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_name\": \"\",\n \"variable_identifier\": \"\",\n \"metadata_type\": \"CONNECTION\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-3cb40db3-0403-449c-b5e5-a7ea306f8df6" }, { "id": "69d9eb05-2fc4-4aa4-8f3c-c137b317e314", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_name\": \"\",\n \"variable_identifier\": \"\",\n \"metadata_type\": \"CONNECTION\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-69d9eb05-2fc4-4aa4-8f3c-c137b317e314" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-0bba2807-3aa9-44e2-b100-11eaedd2d518" } ], "id": "896f1cca-2228-4c5c-9c19-f547e423c3b6", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-896f1cca-2228-4c5c-9c19-f547e423c3b6" }, { "name": "parameterize-fields", "item": [ { "name": "parameterize Metadata Fields", "id": "c47bb733-be44-4aaa-b5db-54e817d76ce6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_names\": [\n \"\",\n \"\"\n ],\n \"variable_identifier\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize-fields" ] }, "description": "\nParameterize multiple fields of metadata objects. For example [schemaName, databaseName] for LOGICAL_TABLE.
Version: 26.5.0.cl or later\n\nAllows parameterizing multiple fields of metadata objects in ThoughtSpot. For example, you can parameterize [schemaName, databaseName] for LOGICAL_TABLE.\n\nRequires appropriate permissions to modify the metadata object.\n\nThe API endpoint allows parameterizing the following types of metadata objects:\n* Logical Tables\n* Connections\n* Connection Configs\n\nFor a Logical Table, the field type must be `ATTRIBUTE` and field names can include:\n* databaseName\n* schemaName\n* tableName\n\nFor a Connection or Connection Config, the field type is always `CONNECTION_PROPERTY`. In this case, field_names specifies the exact properties of the Connection or Connection Config that need to be parameterized.\n\nFor Connection Config, supported field names include:\n* impersonate_user\n\nYou can parameterize multiple fields at once by providing an array of field names.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "fc585d18-ba63-41e3-ae83-ea00a0c3490b", "name": "Parameterize successful.", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_names\": [\n \"\",\n \"\"\n ],\n \"variable_identifier\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize-fields" ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-fc585d18-ba63-41e3-ae83-ea00a0c3490b" }, { "id": "0fe0c4e4-5346-42ac-8b8a-ce63977d19a3", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_names\": [\n \"\",\n \"\"\n ],\n \"variable_identifier\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize-fields" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-0fe0c4e4-5346-42ac-8b8a-ce63977d19a3" }, { "id": "94520960-b7d9-4dc1-bdce-151af29f120a", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_names\": [\n \"\",\n \"\"\n ],\n \"variable_identifier\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize-fields" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-94520960-b7d9-4dc1-bdce-151af29f120a" }, { "id": "4b70854e-9b72-4ed1-a10d-f711301645a9", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_names\": [\n \"\",\n \"\"\n ],\n \"variable_identifier\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize-fields" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-4b70854e-9b72-4ed1-a10d-f711301645a9" }, { "id": "a1cf814e-f07c-4f57-a4a5-865c6751e885", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"CONNECTION_PROPERTY\",\n \"field_names\": [\n \"\",\n \"\"\n ],\n \"variable_identifier\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/parameterize-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "parameterize-fields" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-a1cf814e-f07c-4f57-a4a5-865c6751e885" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-c47bb733-be44-4aaa-b5db-54e817d76ce6" } ], "id": "34e9545c-7266-4e5e-8e0f-61ff234978f7", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-34e9545c-7266-4e5e-8e0f-61ff234978f7" }, { "name": "search", "item": [ { "name": "search Metadata", "id": "2133f459-d66f-4796-9e95-d9aa676c812b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata\": [\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"CONNECTION\",\n \"subtypes\": [\n \"AGGR_WORKSHEET\",\n \"ONE_TO_ONE_LOGICAL\"\n ]\n },\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"TAG\",\n \"subtypes\": [\n \"WORKSHEET\",\n \"AGGR_WORKSHEET\"\n ]\n }\n ],\n \"permissions\": [\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"NO_ACCESS\"\n },\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"READ_ONLY\"\n }\n ],\n \"created_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"dependent_object_version\": \"V1\",\n \"exclude_objects\": [\n {\n \"identifier\": \"\",\n \"type\": \"TAG\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n }\n ],\n \"favorite_object_options\": {\n \"include\": false,\n \"user_identifiers\": [\n \"\",\n \"\"\n ]\n },\n \"include_auto_created_objects\": false,\n \"include_dependent_objects\": false,\n \"dependent_objects_record_size\": 50,\n \"include_details\": false,\n \"include_personalised_views\": false,\n \"include_headers\": true,\n \"include_hidden_objects\": false,\n \"include_incomplete_objects\": false,\n \"include_visualization_headers\": false,\n \"include_worksheet_search_assist_data\": \"\",\n \"modified_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"sort_options\": {\n \"field_name\": \"NAME\",\n \"order\": \"DESC\"\n },\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"include_stats\": false,\n \"include_discoverable_objects\": true,\n \"show_resolved_parameters\": false,\n \"liveboard_response_version\": \"V1\",\n \"include_only_published_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "search" ] }, "description": "\n Version: 9.0.0.cl or later\n\nGets a list of metadata objects available on the ThoughtSpot system.\n\nThis API endpoint is available to all users who have view access to the object. Users with `ADMINISTRATION` (**Can administer ThoughtSpot**) privileges can view data for all metadata objects, including users and groups.\n\n#### Usage guidelines\n\n- To get all metadata objects, send the API request without any attributes.\n- To get metadata objects of a specific type, set the `type` attribute. For example, to fetch a Worksheet, set the type as `LOGICAL_TABLE`.\n- To filter metadata objects within type `LOGICAL_TABLE`, set the `subtypes` attribute. For example, to fetch a Worksheet, set the type as `LOGICAL_TABLE` & subtypes as `[WORKSHEET]`.\n- To get a specific metadata object, specify the GUID.\n- To customize your search and filter the API response, you can use several parameters.\n You can search for objects created or modified by specific users, by tags applied to the objects, or by using the include parameters like `include_auto_created_objects`, `include_dependent_objects`, `include_headers`, `include_incomplete_objects`, and so on.\n You can also define sorting options to sort the data retrieved in the API response.\n- To get discoverable objects when linientmodel is enabled you can use `include_discoverable_objects` as true else false. Default value is true.\n- For liveboard metadata type, to get the newer format, set the `liveboard_response_format` as V2. Default value is V1.\n- To retrieve only objects that are published, set the `include_only_published_objects` as true. Default value is false.\n\n**NOTE**: `obj_identifier` is supported for the following object types: `LIVEBOARD`, `ANSWER`, `LOGICAL_TABLE`, `LOGICAL_COLUMN`, `CONNECTION`, `USER_GROUP`, `COLLECTION`. The response includes the `metadata_obj_id` field for objects that have a Custom object ID set.\n\n**NOTE**: The following parameters support pagination of metadata records:\n\n- `tag_identifiers`\n- `type`\n- `subtypes`\n- `created_by_user_identifiers`\n- `modified_by_user_identifiers`\n- `owned_by_user_identifiers`\n- `exclude_objects`\n- `include_auto_created_objects`\n- `favorite_object_options`\n- `include_only_published_objects`\nIf you are using other parameters to search metadata, set `record_size` to `-1` and `record_offset` to `0`.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "741e08b5-160a-4e7d-9af7-bb119bc0ca5b", "name": "Metadata objects search result.", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"CONNECTION\",\n \"subtypes\": [\n \"AGGR_WORKSHEET\",\n \"ONE_TO_ONE_LOGICAL\"\n ]\n },\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"TAG\",\n \"subtypes\": [\n \"WORKSHEET\",\n \"AGGR_WORKSHEET\"\n ]\n }\n ],\n \"permissions\": [\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"NO_ACCESS\"\n },\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"READ_ONLY\"\n }\n ],\n \"created_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"dependent_object_version\": \"V1\",\n \"exclude_objects\": [\n {\n \"identifier\": \"\",\n \"type\": \"TAG\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n }\n ],\n \"favorite_object_options\": {\n \"include\": false,\n \"user_identifiers\": [\n \"\",\n \"\"\n ]\n },\n \"include_auto_created_objects\": false,\n \"include_dependent_objects\": false,\n \"dependent_objects_record_size\": 50,\n \"include_details\": false,\n \"include_personalised_views\": false,\n \"include_headers\": true,\n \"include_hidden_objects\": false,\n \"include_incomplete_objects\": false,\n \"include_visualization_headers\": false,\n \"include_worksheet_search_assist_data\": \"\",\n \"modified_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"sort_options\": {\n \"field_name\": \"NAME\",\n \"order\": \"DESC\"\n },\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"include_stats\": false,\n \"include_discoverable_objects\": true,\n \"show_resolved_parameters\": false,\n \"liveboard_response_version\": \"V1\",\n \"include_only_published_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "search" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"metadata_type\": \"LIVEBOARD\",\n \"metadata_id\": \"\",\n \"metadata_name\": \"\",\n \"metadata_obj_id\": \"\",\n \"dependent_objects\": {},\n \"metadata_detail\": {},\n \"metadata_header\": {},\n \"stats\": {}\n },\n {\n \"metadata_type\": \"LOGICAL_COLUMN\",\n \"metadata_id\": \"\",\n \"metadata_name\": \"\",\n \"metadata_obj_id\": \"\",\n \"dependent_objects\": {},\n \"metadata_detail\": {},\n \"metadata_header\": {},\n \"stats\": {}\n }\n]", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-741e08b5-160a-4e7d-9af7-bb119bc0ca5b" }, { "id": "68db6128-33fc-4f44-bb76-c81634171f51", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"CONNECTION\",\n \"subtypes\": [\n \"AGGR_WORKSHEET\",\n \"ONE_TO_ONE_LOGICAL\"\n ]\n },\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"TAG\",\n \"subtypes\": [\n \"WORKSHEET\",\n \"AGGR_WORKSHEET\"\n ]\n }\n ],\n \"permissions\": [\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"NO_ACCESS\"\n },\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"READ_ONLY\"\n }\n ],\n \"created_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"dependent_object_version\": \"V1\",\n \"exclude_objects\": [\n {\n \"identifier\": \"\",\n \"type\": \"TAG\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n }\n ],\n \"favorite_object_options\": {\n \"include\": false,\n \"user_identifiers\": [\n \"\",\n \"\"\n ]\n },\n \"include_auto_created_objects\": false,\n \"include_dependent_objects\": false,\n \"dependent_objects_record_size\": 50,\n \"include_details\": false,\n \"include_personalised_views\": false,\n \"include_headers\": true,\n \"include_hidden_objects\": false,\n \"include_incomplete_objects\": false,\n \"include_visualization_headers\": false,\n \"include_worksheet_search_assist_data\": \"\",\n \"modified_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"sort_options\": {\n \"field_name\": \"NAME\",\n \"order\": \"DESC\"\n },\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"include_stats\": false,\n \"include_discoverable_objects\": true,\n \"show_resolved_parameters\": false,\n \"liveboard_response_version\": \"V1\",\n \"include_only_published_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-68db6128-33fc-4f44-bb76-c81634171f51" }, { "id": "2ea4ca2e-0af1-4921-8d62-2b7441978d1a", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"CONNECTION\",\n \"subtypes\": [\n \"AGGR_WORKSHEET\",\n \"ONE_TO_ONE_LOGICAL\"\n ]\n },\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"TAG\",\n \"subtypes\": [\n \"WORKSHEET\",\n \"AGGR_WORKSHEET\"\n ]\n }\n ],\n \"permissions\": [\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"NO_ACCESS\"\n },\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"READ_ONLY\"\n }\n ],\n \"created_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"dependent_object_version\": \"V1\",\n \"exclude_objects\": [\n {\n \"identifier\": \"\",\n \"type\": \"TAG\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n }\n ],\n \"favorite_object_options\": {\n \"include\": false,\n \"user_identifiers\": [\n \"\",\n \"\"\n ]\n },\n \"include_auto_created_objects\": false,\n \"include_dependent_objects\": false,\n \"dependent_objects_record_size\": 50,\n \"include_details\": false,\n \"include_personalised_views\": false,\n \"include_headers\": true,\n \"include_hidden_objects\": false,\n \"include_incomplete_objects\": false,\n \"include_visualization_headers\": false,\n \"include_worksheet_search_assist_data\": \"\",\n \"modified_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"sort_options\": {\n \"field_name\": \"NAME\",\n \"order\": \"DESC\"\n },\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"include_stats\": false,\n \"include_discoverable_objects\": true,\n \"show_resolved_parameters\": false,\n \"liveboard_response_version\": \"V1\",\n \"include_only_published_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-2ea4ca2e-0af1-4921-8d62-2b7441978d1a" }, { "id": "2d2d0179-ed00-459b-a192-2d6ede55d794", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"CONNECTION\",\n \"subtypes\": [\n \"AGGR_WORKSHEET\",\n \"ONE_TO_ONE_LOGICAL\"\n ]\n },\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"TAG\",\n \"subtypes\": [\n \"WORKSHEET\",\n \"AGGR_WORKSHEET\"\n ]\n }\n ],\n \"permissions\": [\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"NO_ACCESS\"\n },\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"READ_ONLY\"\n }\n ],\n \"created_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"dependent_object_version\": \"V1\",\n \"exclude_objects\": [\n {\n \"identifier\": \"\",\n \"type\": \"TAG\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n }\n ],\n \"favorite_object_options\": {\n \"include\": false,\n \"user_identifiers\": [\n \"\",\n \"\"\n ]\n },\n \"include_auto_created_objects\": false,\n \"include_dependent_objects\": false,\n \"dependent_objects_record_size\": 50,\n \"include_details\": false,\n \"include_personalised_views\": false,\n \"include_headers\": true,\n \"include_hidden_objects\": false,\n \"include_incomplete_objects\": false,\n \"include_visualization_headers\": false,\n \"include_worksheet_search_assist_data\": \"\",\n \"modified_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"sort_options\": {\n \"field_name\": \"NAME\",\n \"order\": \"DESC\"\n },\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"include_stats\": false,\n \"include_discoverable_objects\": true,\n \"show_resolved_parameters\": false,\n \"liveboard_response_version\": \"V1\",\n \"include_only_published_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-2d2d0179-ed00-459b-a192-2d6ede55d794" }, { "id": "0e3a2af9-0464-40e5-ba3c-2bc9e6e03cad", "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 \"metadata\": [\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"CONNECTION\",\n \"subtypes\": [\n \"AGGR_WORKSHEET\",\n \"ONE_TO_ONE_LOGICAL\"\n ]\n },\n {\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"name_pattern\": \"\",\n \"type\": \"TAG\",\n \"subtypes\": [\n \"WORKSHEET\",\n \"AGGR_WORKSHEET\"\n ]\n }\n ],\n \"permissions\": [\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"NO_ACCESS\"\n },\n {\n \"principal\": {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n },\n \"share_mode\": \"READ_ONLY\"\n }\n ],\n \"created_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"dependent_object_version\": \"V1\",\n \"exclude_objects\": [\n {\n \"identifier\": \"\",\n \"type\": \"TAG\"\n },\n {\n \"identifier\": \"\",\n \"type\": \"USER_GROUP\"\n }\n ],\n \"favorite_object_options\": {\n \"include\": false,\n \"user_identifiers\": [\n \"\",\n \"\"\n ]\n },\n \"include_auto_created_objects\": false,\n \"include_dependent_objects\": false,\n \"dependent_objects_record_size\": 50,\n \"include_details\": false,\n \"include_personalised_views\": false,\n \"include_headers\": true,\n \"include_hidden_objects\": false,\n \"include_incomplete_objects\": false,\n \"include_visualization_headers\": false,\n \"include_worksheet_search_assist_data\": \"\",\n \"modified_by_user_identifiers\": [\n \"\",\n \"\"\n ],\n \"record_offset\": 0,\n \"record_size\": 10,\n \"sort_options\": {\n \"field_name\": \"NAME\",\n \"order\": \"DESC\"\n },\n \"tag_identifiers\": [\n \"\",\n \"\"\n ],\n \"include_stats\": false,\n \"include_discoverable_objects\": true,\n \"show_resolved_parameters\": false,\n \"liveboard_response_version\": \"V1\",\n \"include_only_published_objects\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-0e3a2af9-0464-40e5-ba3c-2bc9e6e03cad" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-2133f459-d66f-4796-9e95-d9aa676c812b" } ], "id": "01d607ae-72e0-4bb2-b8d8-ef873ccb1fd8", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-01d607ae-72e0-4bb2-b8d8-ef873ccb1fd8" }, { "name": "unparameterize", "item": [ { "name": "unparameterize Metadata", "id": "8e70b21f-1e79-4f74-bad7-96b21fadf3c6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata_identifier\": \"\",\n \"field_type\": \"ATTRIBUTE\",\n \"field_name\": \"\",\n \"value\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/unparameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "unparameterize" ] }, "description": "\nRemove parameterization from fields in metadata objects.
Version: 26.5.0.cl or later\n\nAllows removing parameterization from fields in metadata objects in ThoughtSpot.\n\nRequires appropriate permissions to modify the metadata object.\n\nThe API endpoint allows unparameterizing the following types of metadata objects:\n* Logical Tables\n* Connections\n* Connection Configs\n\nFor a Logical Table the field type must be `ATTRIBUTE` and field name can be one of:\n* databaseName\n* schemaName\n* tableName\n\nFor a Connection or Connection Config, the field type is always `CONNECTION_PROPERTY`. In this case, field_name specifies the exact property of the Connection or Connection Config that needs to be unparameterized.\n\nFor Connection Config, the only supported field name is:\n* impersonate_user\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "6dff14c1-f52e-4e3f-8723-07d5dcfd6a55", "name": "Successfuly removed parameters.", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"ATTRIBUTE\",\n \"field_name\": \"\",\n \"value\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/unparameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "unparameterize" ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-6dff14c1-f52e-4e3f-8723-07d5dcfd6a55" }, { "id": "27ea7b3f-a8b4-4005-97f0-234c8db905cc", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"ATTRIBUTE\",\n \"field_name\": \"\",\n \"value\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/unparameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "unparameterize" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-27ea7b3f-a8b4-4005-97f0-234c8db905cc" }, { "id": "f18bfaf7-fc91-4e73-8f77-ae91df5850a7", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"ATTRIBUTE\",\n \"field_name\": \"\",\n \"value\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/unparameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "unparameterize" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-f18bfaf7-fc91-4e73-8f77-ae91df5850a7" }, { "id": "cae9180c-2600-4c3c-b283-4023f854062b", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"ATTRIBUTE\",\n \"field_name\": \"\",\n \"value\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/unparameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "unparameterize" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-cae9180c-2600-4c3c-b283-4023f854062b" }, { "id": "a46f28aa-5d64-4a08-853c-43d20009e326", "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 \"metadata_identifier\": \"\",\n \"field_type\": \"ATTRIBUTE\",\n \"field_name\": \"\",\n \"value\": \"\",\n \"metadata_type\": \"LOGICAL_TABLE\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/unparameterize", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "unparameterize" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-a46f28aa-5d64-4a08-853c-43d20009e326" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-8e70b21f-1e79-4f74-bad7-96b21fadf3c6" } ], "id": "8f1dceb1-950b-4695-b4b1-3fd8e2ccbbd0", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-8f1dceb1-950b-4695-b4b1-3fd8e2ccbbd0" }, { "name": "headers", "item": [ { "name": "update", "item": [ { "name": "update Metadata Header", "id": "fe006323-1c02-4c31-8fef-c1e87f178fc5", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"headers_update\": [\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_COLUMN\"\n },\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_TABLE\"\n }\n ],\n \"org_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/headers/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "headers", "update" ] }, "description": "\nUpdate header attributes for a given list of header objects.
Beta Version: 10.6.0.cl or later\n\n## Prerequisites\n- **Privileges Required:**\n - `DATAMANAGEMENT` (Can manage data) or `ADMINISTRATION` (Can administer ThoughtSpot).\n- **Additional Privileges (if RBAC is enabled):**\n - `ORG_ADMINISTRATION` (Can manage orgs).\n\n---\n\n## Usage Guidelines\n\n### Parameters\n\n1. **headers_update** \n - **Description:** List of header objects with their attributes to be updated. Each object contains a list of attributes to be updated in the header.\n - **Usage:**\n - You must provide either `identifier` or `obj_identifier`, but not both. Both fields cannot be empty.\n - When `org_identifier` is set to `-1`, only the `identifier` value is accepted; `obj_identifier` is not allowed.\n\n2. **org_identifier** \n - **Description:** GUID (Globally Unique Identifier) or name of the organization. \n - **Usage:**\n - Leaving this field empty assumes that the changes should be applied to the current organization \n - Provide `org_guid` or `org_name` to uniquely identify the organization where changes need to be applied. .\n - Provide `-1` if changes have to be applied across all the org.\n\n---\n\n## Note\nCurrently, this API is enabled only for updating the `obj_identifier` attribute. Only `text` will be allowed in attribute's value.\n\n## Best Practices\n\n1. **Backup Before Conversion:** \n Always export metadata as a backup before initiating the update process\n\n---\n\n## Examples\n\n### Only `identifier` is given \n```json\n{\n \"headers_update\":\n [\n {\n \"identifier\": \"guid_1\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_COLUMN\",\n \"attributes\":\n [\n {\n \"name\": \"obj_id\",\n \"value\": \"custom_object_id\"\n }\n ]\n }\n ],\n \"org_identifier\": \"orgGuid\"\n}\n```\n\n### Only `obj_identifier` is given\n```json\n{\n \"headers_update\":\n [\n {\n \"obj_identifier\": \"custom_object_id\",\n \"type\": \"ANSWER\",\n \"attributes\":\n [\n {\n \"name\": \"obj_id\",\n \"value\": \"custom_object_id\"\n }\n ]\n }\n ],\n \"org_identifier\": \"orgName\"\n}\n```\n\n### Executing update for all org `-1`\n```json\n{\n \"headers_update\":\n [\n {\n \"identifier\": \"guid_1\",\n \"type\": \"ANSWER\",\n \"attributes\":\n [\n {\n \"name\": \"obj_id\",\n \"value\": \"custom_object_id\"\n }\n ]\n }\n ],\n \"org_identifier\": -1\n}\n```\n\n### Optional `type` is not provided\n```json\n{\n \"headers_update\":\n [\n {\n \"identifier\": \"guid_1\",\n \"attributes\":\n [\n {\n \"name\": \"obj_id\",\n \"value\": \"custom_object_id\"\n }\n ]\n }\n ],\n \"org_identifier\": -1\n}\n```\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "79b6fb65-5e5c-473a-a7fa-4bbb581224dc", "name": "Headers update was successful.", "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 \"headers_update\": [\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_COLUMN\"\n },\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_TABLE\"\n }\n ],\n \"org_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/headers/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "headers", "update" ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-79b6fb65-5e5c-473a-a7fa-4bbb581224dc" }, { "id": "f48a360b-8bc2-413f-806d-4dbbf8df4088", "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 \"headers_update\": [\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_COLUMN\"\n },\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_TABLE\"\n }\n ],\n \"org_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/headers/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "headers", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-f48a360b-8bc2-413f-806d-4dbbf8df4088" }, { "id": "acf70121-bce0-4a64-9739-a9095bada406", "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 \"headers_update\": [\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_COLUMN\"\n },\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_TABLE\"\n }\n ],\n \"org_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/headers/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "headers", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-acf70121-bce0-4a64-9739-a9095bada406" }, { "id": "1b53c5a5-a1d9-45b5-ba33-ac8f80247936", "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 \"headers_update\": [\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_COLUMN\"\n },\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_TABLE\"\n }\n ],\n \"org_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/headers/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "headers", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-1b53c5a5-a1d9-45b5-ba33-ac8f80247936" }, { "id": "15371627-a6bc-4155-9a1c-0877a57cfde6", "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 \"headers_update\": [\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_COLUMN\"\n },\n {\n \"attributes\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"identifier\": \"\",\n \"obj_identifier\": \"\",\n \"type\": \"LOGICAL_TABLE\"\n }\n ],\n \"org_identifier\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/headers/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "headers", "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-15371627-a6bc-4155-9a1c-0877a57cfde6" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-fe006323-1c02-4c31-8fef-c1e87f178fc5" } ], "id": "c3344eff-2c50-4cb6-a4ac-e6ba9efecbbb", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-c3344eff-2c50-4cb6-a4ac-e6ba9efecbbb" } ], "id": "860d1b09-5435-4124-9154-36cbf9ab0feb", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-860d1b09-5435-4124-9154-36cbf9ab0feb" }, { "name": "update-obj-id", "item": [ { "name": "update Metadata Obj Id", "id": "7bd96270-7e94-4198-8c13-7bb37608c2f8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"metadata\": [\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"USER_GROUP\",\n \"current_obj_id\": \"\"\n },\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"COLLECTION\",\n \"current_obj_id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/update-obj-id", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "update-obj-id" ] }, "description": "\nUpdate object IDs for given metadata objects.
Beta Version: 10.8.0.cl or later\n\n## Prerequisites\n- **Privileges Required:**\n - `DATAMANAGEMENT` (Can manage data) or `ADMINISTRATION` (Can administer ThoughtSpot).\n- **Additional Privileges (if RBAC is enabled):**\n - `ORG_ADMINISTRATION` (Can manage orgs).\n\n---\n\n## Usage Guidelines\n\n### Parameters\n\n1. **metadata** \n - **Description:** List of metadata objects to update their object IDs.\n - **Usage:**\n - Use either `current_obj_id` alone OR use `metadata_identifier` with `type` (when needed).\n - When using `metadata_identifier`, the `type` field is required if using a name instead of a GUID.\n - The `new_obj_id` field is always required.\n\n---\n\n## Note\nThis API is specifically designed for updating object IDs of metadata objects. It internally uses the header update mechanism to perform the changes.\n\n## Best Practices\n\n1. **Backup Before Update:** \n Always export metadata as a backup before initiating the update process.\n\n2. **Validation:**\n - When using `current_obj_id`, ensure it matches the existing object ID exactly.\n - When using `metadata_identifier` with a name, ensure the `type` is specified correctly.\n - Verify that the `new_obj_id` follows your naming conventions and is unique within your system.\n\n---\n\n## Examples\n\n### Using current_obj_id\n```json\n{\n \"metadata\": [\n {\n \"current_obj_id\": \"existing_object_id\",\n \"new_obj_id\": \"new_object_id\"\n }\n ]\n}\n```\n\n### Using metadata_identifier with GUID\n```json\n{\n \"metadata\": [\n {\n \"metadata_identifier\": \"01234567-89ab-cdef-0123-456789abcdef\",\n \"new_obj_id\": \"new_object_id\"\n }\n ]\n}\n```\n\n### Using metadata_identifier with name and type\n```json\n{\n \"metadata\": [\n {\n \"metadata_identifier\": \"My Answer\",\n \"type\": \"ANSWER\",\n \"new_obj_id\": \"new_object_id\"\n }\n ]\n}\n```\n\n### Multiple objects update\n```json\n{\n \"metadata\": [\n {\n \"current_obj_id\": \"existing_object_id_1\",\n \"new_obj_id\": \"new_object_id_1\"\n },\n {\n \"metadata_identifier\": \"My Worksheet\",\n \"type\": \"LOGICAL_TABLE\",\n \"new_obj_id\": \"new_object_id_2\"\n }\n ]\n}\n```\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "be936f3e-eeae-44a9-a3f7-a21eb72473c6", "name": "Headers update was successful.", "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 \"metadata\": [\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"USER_GROUP\",\n \"current_obj_id\": \"\"\n },\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"COLLECTION\",\n \"current_obj_id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/update-obj-id", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "update-obj-id" ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-be936f3e-eeae-44a9-a3f7-a21eb72473c6" }, { "id": "46e3fe5e-8000-4e2a-9b69-438dfcd3d7c5", "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 \"metadata\": [\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"USER_GROUP\",\n \"current_obj_id\": \"\"\n },\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"COLLECTION\",\n \"current_obj_id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/update-obj-id", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "update-obj-id" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-46e3fe5e-8000-4e2a-9b69-438dfcd3d7c5" }, { "id": "cf91fb6a-0231-484c-86e2-b67aad946216", "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 \"metadata\": [\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"USER_GROUP\",\n \"current_obj_id\": \"\"\n },\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"COLLECTION\",\n \"current_obj_id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/update-obj-id", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "update-obj-id" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-cf91fb6a-0231-484c-86e2-b67aad946216" }, { "id": "be3c091c-061e-4b16-9e49-163469cf514b", "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 \"metadata\": [\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"USER_GROUP\",\n \"current_obj_id\": \"\"\n },\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"COLLECTION\",\n \"current_obj_id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/update-obj-id", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "update-obj-id" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-be3c091c-061e-4b16-9e49-163469cf514b" }, { "id": "9e4ec579-f08f-4a71-accf-1456b8139dfc", "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 \"metadata\": [\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"USER_GROUP\",\n \"current_obj_id\": \"\"\n },\n {\n \"new_obj_id\": \"\",\n \"metadata_identifier\": \"\",\n \"type\": \"COLLECTION\",\n \"current_obj_id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/metadata/update-obj-id", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "metadata", "update-obj-id" ] } }, "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:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-9e4ec579-f08f-4a71-accf-1456b8139dfc" } ], "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-7bd96270-7e94-4198-8c13-7bb37608c2f8" } ], "id": "9d72b1f7-77ec-4a7b-a865-ce77f4ce4ad2", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-9d72b1f7-77ec-4a7b-a865-ce77f4ce4ad2" } ], "id": "f39c53c8-b771-441e-a6b4-cfd1c98eb2fc", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-f39c53c8-b771-441e-a6b4-cfd1c98eb2fc" } ], "id": "080d2f5a-70d1-4cd8-84c4-dc29c42be8fe", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-080d2f5a-70d1-4cd8-84c4-dc29c42be8fe" } ], "id": "96c786dc-695a-4c71-9559-f74b1b024cc8", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-96c786dc-695a-4c71-9559-f74b1b024cc8" } ], "id": "8c97a667-56ec-4d75-9c85-fa43dc1332b5", "createdAt": "2026-07-28T03:16:09.000Z", "updatedAt": "2026-07-28T03:16:09.000Z", "uid": "35240-8c97a667-56ec-4d75-9c85-fa43dc1332b5" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "base-url", "value": "https://localhost:443" }, { "key": "baseUrl", "value": "{{base-url}}" } ] }