{ "info": { "_postman_id": "c4dc30e8-f9c8-4c15-9c3a-6b1cfc229133", "name": "ThoughtSpot Public REST 10.1.0.cl Roles API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "lastUpdatedBy": "35240", "uid": "35240-c4dc30e8-f9c8-4c15-9c3a-6b1cfc229133" }, "item": [ { "name": "api", "item": [ { "name": "rest", "item": [ { "name": "2.0", "item": [ { "name": "roles", "item": [ { "name": "create", "item": [ { "name": "create Role", "id": "8f7998d2-2fd7-4f83-9653-0e4e2695197e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"CAN_CREATE_OR_EDIT_CONNECTIONS\",\n \"USER_ADMINISTRATION\"\n ],\n \"read_only\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "create" ] }, "description": "\n Version: 9.5.0.cl or later\n\nCreates a Role object in ThoughtSpot.\n\nAvailable only if [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance. To create a Role, the `ROLE_ADMINISTRATION` (**Can manage roles**) privilege is required.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "014dc5c4-ca9e-47c8-9dbc-ebf91abf4693", "name": "Role successfully created.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"CAN_CREATE_OR_EDIT_CONNECTIONS\",\n \"USER_ADMINISTRATION\"\n ],\n \"read_only\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "create" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"DEVELOPER\",\n \"CAN_DOWNLOAD_VISUALS\"\n ],\n \"groups_assigned_count\": \"\",\n \"orgs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"permission\": \"MODIFY\",\n \"author_id\": \"\",\n \"modifier_id\": \"\",\n \"creation_time_in_millis\": {},\n \"modification_time_in_millis\": {},\n \"deleted\": \"\",\n \"deprecated\": \"\",\n \"external\": \"\",\n \"hidden\": \"\",\n \"shared_via_connection\": \"\"\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-014dc5c4-ca9e-47c8-9dbc-ebf91abf4693" }, { "id": "64275bae-60cd-464c-be34-22b4df896388", "name": "Invalid parameters.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"CAN_CREATE_OR_EDIT_CONNECTIONS\",\n \"USER_ADMINISTRATION\"\n ],\n \"read_only\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "create" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-64275bae-60cd-464c-be34-22b4df896388" }, { "id": "8bbdf363-c9bd-475d-bd59-dcbf278438ac", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"CAN_CREATE_OR_EDIT_CONNECTIONS\",\n \"USER_ADMINISTRATION\"\n ],\n \"read_only\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "create" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-8bbdf363-c9bd-475d-bd59-dcbf278438ac" }, { "id": "77e291d1-b8fa-4b89-9a36-93e08630b2ff", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"CAN_CREATE_OR_EDIT_CONNECTIONS\",\n \"USER_ADMINISTRATION\"\n ],\n \"read_only\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "create" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-77e291d1-b8fa-4b89-9a36-93e08630b2ff" }, { "id": "b5963d6d-917b-46f6-8833-3e3bb85887a5", "name": "Internal error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"CAN_CREATE_OR_EDIT_CONNECTIONS\",\n \"USER_ADMINISTRATION\"\n ],\n \"read_only\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/create", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "create" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-b5963d6d-917b-46f6-8833-3e3bb85887a5" } ], "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-8f7998d2-2fd7-4f83-9653-0e4e2695197e" } ], "id": "8752bf5e-3f77-4f08-a91c-704e9ce05929", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-8752bf5e-3f77-4f08-a91c-704e9ce05929" }, { "name": "{role_identifier}", "item": [ { "name": "delete", "item": [ { "name": "delete Role", "id": "2e9aa62b-24ad-4ae1-ab41-21722b0a5b23", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "delete" ], "variable": [ { "id": "2be25d6e-0d00-43eb-976d-3c051d110575", "key": "role_identifier", "value": "", "description": "(Required) Unique ID or name of the Role. ReadOnly roles cannot be deleted." } ] }, "description": "\n Version: 9.5.0.cl or later\n\nDeletes a Role object from the ThoughtSpot system.\n\nAvailable only if [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance. To delete a Role, the `ROLE_ADMINISTRATION` (**Can manage roles**) privilege is required.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "6f575497-e755-4c2f-ae13-edae29f793f7", "name": "Role successfully deleted.", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "delete" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-6f575497-e755-4c2f-ae13-edae29f793f7" }, { "id": "5783a6bb-a47b-4860-b0a0-844b9115ee0a", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "delete" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-5783a6bb-a47b-4860-b0a0-844b9115ee0a" }, { "id": "f5a85b5e-3d83-492b-b357-2dcc6149229c", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "delete" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-f5a85b5e-3d83-492b-b357-2dcc6149229c" }, { "id": "16c16f0c-3652-48b6-a425-c3ed7de5b34f", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "delete" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-16c16f0c-3652-48b6-a425-c3ed7de5b34f" }, { "id": "57af5d02-f18f-4cfd-bce8-08c33f50948f", "name": "Internal error", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "delete" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-57af5d02-f18f-4cfd-bce8-08c33f50948f" } ], "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-2e9aa62b-24ad-4ae1-ab41-21722b0a5b23" } ], "id": "d9616258-0095-451a-b512-4b2db9c0b837", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-d9616258-0095-451a-b512-4b2db9c0b837" }, { "name": "update", "item": [ { "name": "update Role", "id": "1d33868c-9c20-43f2-918d-869269fcbd63", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"JOBSCHEDULING\",\n \"DEVELOPER\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "update" ], "variable": [ { "id": "6788a442-ce3a-4373-8fff-a06b30deb2f2", "key": "role_identifier", "value": "", "description": "(Required) Unique ID or name of the Role." } ] }, "description": "\n Version: 9.5.0.cl or later\n\nUpdates the properties of a Role object.\n\nAvailable only if [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance. To update a Role, the `ROLE_ADMINISTRATION` (**Can manage roles**) privilege is required.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "17615671-d7c7-4223-bbf0-83d1ecca9e13", "name": "Role successfully updated.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"JOBSCHEDULING\",\n \"DEVELOPER\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "update" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"DEVELOPER\",\n \"CAN_DOWNLOAD_VISUALS\"\n ],\n \"groups_assigned_count\": \"\",\n \"orgs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"permission\": \"MODIFY\",\n \"author_id\": \"\",\n \"modifier_id\": \"\",\n \"creation_time_in_millis\": {},\n \"modification_time_in_millis\": {},\n \"deleted\": \"\",\n \"deprecated\": \"\",\n \"external\": \"\",\n \"hidden\": \"\",\n \"shared_via_connection\": \"\"\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-17615671-d7c7-4223-bbf0-83d1ecca9e13" }, { "id": "26b82936-bb86-4b87-97d7-c1a10d673bf7", "name": "Invalid request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"JOBSCHEDULING\",\n \"DEVELOPER\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "update" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-26b82936-bb86-4b87-97d7-c1a10d673bf7" }, { "id": "9aa8fa45-8362-4c8a-9871-6bf3ff2186ce", "name": "Unauthorized access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"JOBSCHEDULING\",\n \"DEVELOPER\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "update" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-9aa8fa45-8362-4c8a-9871-6bf3ff2186ce" }, { "id": "11c32115-e06e-458e-a64d-ffd69edf4132", "name": "Forbidden access.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"JOBSCHEDULING\",\n \"DEVELOPER\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "update" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-11c32115-e06e-458e-a64d-ffd69edf4132" }, { "id": "04d345f1-af1a-423d-a8fc-ded30a361015", "name": "Unexpected error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"JOBSCHEDULING\",\n \"DEVELOPER\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/:role_identifier/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", ":role_identifier", "update" ], "variable": [ { "key": "role_identifier" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {}\n}", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-04d345f1-af1a-423d-a8fc-ded30a361015" } ], "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-1d33868c-9c20-43f2-918d-869269fcbd63" } ], "id": "ddc05320-94b5-44a2-9407-04132e8cc880", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-ddc05320-94b5-44a2-9407-04132e8cc880" } ], "id": "0140be98-5fb8-4c4d-a22d-4ebef466230e", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-0140be98-5fb8-4c4d-a22d-4ebef466230e" }, { "name": "search", "item": [ { "name": "search Roles", "id": "61696be6-8112-4f99-b977-26f7091cb363", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"role_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ],\n \"group_identifiers\": [\n \"\",\n \"\"\n ],\n \"privileges\": [\n \"ALLOW_NON_EMBED_FULL_APP_ACCESS\",\n \"ORG_ADMINISTRATION\"\n ],\n \"deprecated\": \"\",\n \"external\": \"\",\n \"shared_via_connection\": \"\",\n \"permissions\": [\n \"READ_ONLY\",\n \"MODIFY\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "search" ] }, "description": "\n Version: 9.5.0.cl or later\n\nGets a list of Role objects from the ThoughtSpot system.\n\nAvailable if [Role-Based Access Control (RBAC)](https://developers.thoughtspot.com/docs/rbac) is enabled on your instance. To search for Roles, the `ROLE_ADMINISTRATION` (**Can manage roles**) privilege is required.\n\nTo get details of a specific Role object, specify the GUID or name. You can also filter the API response based on user group and Org identifiers, privileges assigned to the Role, and deprecation status.\n\n**NOTE**: In addition to the GUID and name, `role_identifiers` accepts a Custom object ID if one is configured for the role. The response also includes the `obj_id` field for each role that has one set.\n\n\n\n\n#### Endpoint URL\n" }, "response": [ { "id": "090af02c-2226-4d69-a89a-d9fdbb384c0e", "name": "Roles 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 \"role_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ],\n \"group_identifiers\": [\n \"\",\n \"\"\n ],\n \"privileges\": [\n \"ALLOW_NON_EMBED_FULL_APP_ACCESS\",\n \"ORG_ADMINISTRATION\"\n ],\n \"deprecated\": \"\",\n \"external\": \"\",\n \"shared_via_connection\": \"\",\n \"permissions\": [\n \"READ_ONLY\",\n \"MODIFY\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "search" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"CAN_CREATE_OR_EDIT_CONNECTIONS\",\n \"CAN_ACCESS_ANALYST_STUDIO\"\n ],\n \"obj_id\": \"\",\n \"groups_assigned_count\": \"\",\n \"orgs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"permission\": \"MODIFY\",\n \"author_id\": \"\",\n \"modifier_id\": \"\",\n \"creation_time_in_millis\": {},\n \"modification_time_in_millis\": {},\n \"deleted\": \"\",\n \"deprecated\": \"\",\n \"external\": \"\",\n \"hidden\": \"\",\n \"shared_via_connection\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"privileges\": [\n \"CAN_MANAGE_SPOTTER\",\n \"TAGMANAGEMENT\"\n ],\n \"obj_id\": \"\",\n \"groups_assigned_count\": \"\",\n \"orgs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"permission\": \"READ_ONLY\",\n \"author_id\": \"\",\n \"modifier_id\": \"\",\n \"creation_time_in_millis\": {},\n \"modification_time_in_millis\": {},\n \"deleted\": \"\",\n \"deprecated\": \"\",\n \"external\": \"\",\n \"hidden\": \"\",\n \"shared_via_connection\": \"\"\n }\n]", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-090af02c-2226-4d69-a89a-d9fdbb384c0e" }, { "id": "bee74f69-5c09-45d9-b2d7-2f56e8d81236", "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 \"role_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ],\n \"group_identifiers\": [\n \"\",\n \"\"\n ],\n \"privileges\": [\n \"ALLOW_NON_EMBED_FULL_APP_ACCESS\",\n \"ORG_ADMINISTRATION\"\n ],\n \"deprecated\": \"\",\n \"external\": \"\",\n \"shared_via_connection\": \"\",\n \"permissions\": [\n \"READ_ONLY\",\n \"MODIFY\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "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:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-bee74f69-5c09-45d9-b2d7-2f56e8d81236" }, { "id": "9ea9669e-53d3-4c6b-8956-4a307da1fef3", "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 \"role_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ],\n \"group_identifiers\": [\n \"\",\n \"\"\n ],\n \"privileges\": [\n \"ALLOW_NON_EMBED_FULL_APP_ACCESS\",\n \"ORG_ADMINISTRATION\"\n ],\n \"deprecated\": \"\",\n \"external\": \"\",\n \"shared_via_connection\": \"\",\n \"permissions\": [\n \"READ_ONLY\",\n \"MODIFY\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "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:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-9ea9669e-53d3-4c6b-8956-4a307da1fef3" }, { "id": "909dce84-05dd-4b55-a307-57de3c9a768f", "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 \"role_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ],\n \"group_identifiers\": [\n \"\",\n \"\"\n ],\n \"privileges\": [\n \"ALLOW_NON_EMBED_FULL_APP_ACCESS\",\n \"ORG_ADMINISTRATION\"\n ],\n \"deprecated\": \"\",\n \"external\": \"\",\n \"shared_via_connection\": \"\",\n \"permissions\": [\n \"READ_ONLY\",\n \"MODIFY\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "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:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-909dce84-05dd-4b55-a307-57de3c9a768f" }, { "id": "b8ae61b7-5729-4bbf-99d1-064123da90d8", "name": "Internal 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 \"role_identifiers\": [\n \"\",\n \"\"\n ],\n \"org_identifiers\": [\n \"\",\n \"\"\n ],\n \"group_identifiers\": [\n \"\",\n \"\"\n ],\n \"privileges\": [\n \"ALLOW_NON_EMBED_FULL_APP_ACCESS\",\n \"ORG_ADMINISTRATION\"\n ],\n \"deprecated\": \"\",\n \"external\": \"\",\n \"shared_via_connection\": \"\",\n \"permissions\": [\n \"READ_ONLY\",\n \"MODIFY\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/rest/2.0/roles/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "rest", "2.0", "roles", "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:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-b8ae61b7-5729-4bbf-99d1-064123da90d8" } ], "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-61696be6-8112-4f99-b977-26f7091cb363" } ], "id": "953e5dfe-8aea-42e9-b93d-76e25139fa2e", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-953e5dfe-8aea-42e9-b93d-76e25139fa2e" } ], "id": "0e255bc9-fd9b-4225-a093-94cab0f72d39", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-0e255bc9-fd9b-4225-a093-94cab0f72d39" } ], "id": "03555feb-bd94-4ea3-943a-3dfd22e5b483", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-03555feb-bd94-4ea3-943a-3dfd22e5b483" } ], "id": "4dce6850-f320-4d22-add5-f8407b6ba875", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-4dce6850-f320-4d22-add5-f8407b6ba875" } ], "id": "ad409ac8-1c78-4439-b797-524700873f51", "createdAt": "2026-07-28T03:16:31.000Z", "updatedAt": "2026-07-28T03:16:31.000Z", "uid": "35240-ad409ac8-1c78-4439-b797-524700873f51" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "base-url", "value": "https://localhost:443" }, { "key": "baseUrl", "value": "{{base-url}}" } ] }