{ "info": { "_postman_id": "e49a624e-60e6-43d1-b1b7-bd81d3e526ff", "name": "ThoughtSpot Public REST 10.1.0.cl 10.8.0.cl API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "lastUpdatedBy": "35240", "uid": "35240-e49a624e-60e6-43d1-b1b7-bd81d3e526ff" }, "item": [ { "name": "api", "item": [ { "name": "rest", "item": [ { "name": "2.0", "item": [ { "name": "metadata", "item": [ { "name": "update-obj-id", "item": [ { "name": "update Metadata Obj Id", "id": "1650bfb1-4947-47b8-9d44-11c77615a4c2", "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\": \"LOGICAL_COLUMN\",\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": "095e51c2-f2fd-42a0-acd9-ded4ceb6cb87", "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\": \"LOGICAL_COLUMN\",\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:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-095e51c2-f2fd-42a0-acd9-ded4ceb6cb87" }, { "id": "0b613f10-94f0-4180-9609-8e0bfaec2e31", "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\": \"LOGICAL_COLUMN\",\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:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-0b613f10-94f0-4180-9609-8e0bfaec2e31" }, { "id": "f4229c8a-00e0-42f6-afa2-dcb6956c6a54", "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\": \"LOGICAL_COLUMN\",\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:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-f4229c8a-00e0-42f6-afa2-dcb6956c6a54" }, { "id": "bd9355c3-3160-4dbc-b25e-0c9d59ba03af", "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\": \"LOGICAL_COLUMN\",\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:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-bd9355c3-3160-4dbc-b25e-0c9d59ba03af" }, { "id": "adb6a1df-c064-4b07-ae91-9e8e5e5159b7", "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\": \"LOGICAL_COLUMN\",\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:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-adb6a1df-c064-4b07-ae91-9e8e5e5159b7" } ], "createdAt": "2026-07-28T03:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-1650bfb1-4947-47b8-9d44-11c77615a4c2" } ], "id": "e292e692-7349-4e5a-add3-8fb5e5656e20", "createdAt": "2026-07-28T03:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-e292e692-7349-4e5a-add3-8fb5e5656e20" } ], "id": "db636e10-b289-4f77-bf0a-39ca31efd474", "createdAt": "2026-07-28T03:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-db636e10-b289-4f77-bf0a-39ca31efd474" } ], "id": "3bb472e2-8d01-45f2-be60-c98cb6d0d621", "createdAt": "2026-07-28T03:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-3bb472e2-8d01-45f2-be60-c98cb6d0d621" } ], "id": "09db29a1-d9be-400a-8cac-ec35bad9dfa4", "createdAt": "2026-07-28T03:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-09db29a1-d9be-400a-8cac-ec35bad9dfa4" } ], "id": "21b94020-dde7-4ae1-9ea3-61e371dbf0b1", "createdAt": "2026-07-28T03:13:49.000Z", "updatedAt": "2026-07-28T03:13:49.000Z", "uid": "35240-21b94020-dde7-4ae1-9ea3-61e371dbf0b1" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "base-url", "value": "https://localhost:443" }, { "key": "baseUrl", "value": "{{base-url}}" } ] }