REST API v1 changelog

REST API v1 changelog

This changelog lists only the changes introduced in REST API v1. For information about new embedding features and enhancements, see What’s New.

Version 10.1.0.cl, August 2024🔗

You can now export TML representation of User, User Group, and Role objects via post /tspublic/v1/metadata/tml/export/batch. This feature helps migrate content from one Org or one instance to another.

For more information, see Export TML objects in bulk.

Version 9.12.5.cl, June 2024🔗

You can now define user attributes in your API request to the /tspublic/v1/session/auth/token endpoint and obtain an authentication token (JWT) and security entitlements for a given user during session creation.

For more information, see Session token API and Attribute-Based Access Control.

Version 9.12.0.cl, May 2024🔗

The /tspublic/v1/metadata/tml/export API request supports the following parameters:

  • export_dependent
    Allows exporting dependent Tables while exporting a Connection.

  • export_connection_as_dependent
    Specifies if a Connection can be exported as a dependent object when exporting a Table, Worksheet, Answer, or Liveboard. This parameter works only when export_associated is set to true in the API request.

  • all_orgs_override
    Specifies if the export request is sent from all Orgs context.

For more information, see TML API.

Version 9.10.0.cl, March 2024🔗

New API endpoint

GET tspublic/v1/admin/banner
Gets cluster maintenance status and banner text.

For more information, see Cluster maintenance and upgrade.

TML API

The /tspublic/v1/metadata/tml/export API request supports the export_schema_version attribute.
You can use this parameter to specify the schema version for datasets during TML export. By default, the API request uses v1 schema for Worksheet TML export. For Models, set export_schema_version to v2.
For more information, see TML API.

Version 9.5.0.cl, September 2023🔗

This release introduces the REST API v1 endpoints to create and manage roles and implement Role-Based Access Control Beta:

  • POST /tspublic/v1/role
    Creates a role and assign privileges

  • PUT /tspublic/v1/role/{role_identifier}
    Updates the properties of a role object

  • POST /tspublic/v1/role/search
    Gets details of roles and the object properties.

  • DELETE /tspublic/v1/role/{role_identifier}
    Deletes a role object.

For more information, see Role-based Access Control and Role API.

Note

The roles APIs work only if the Role-Based Access Control (RBAC) Beta feature is enabled on your instance. The RBAC feature is turned off by default. To enable this feature, contact ThoughtSpot Support.

Versions 9.3.0.cl and 9.4.0.cl🔗

No new changes were introduced in the 9.3.0.cl and 9.4.0.cl releases.

Version 9.2.0.cl, May 2023🔗

The 9.2.0.cl release introduces the following enhancements:

  • The /tspublic/v1/pinboarddata and /tspublic/v1/searchdata API endpoints support applying parameter overrides at runtime. You can pass Worksheet parameters in the request URL when making an API call to these endpoints and adjust parameter values to optimize your queries.

  • The /tspublic/v1/session/login API endpoint now allows users to log in to a specific Org with basic authentication.

Version 9.0.0.cl, February 2023🔗

The 9.0.0.cl release introduces the /tspublic/v1/metadata/delete endpoint, using which you can delete a metadata object.

For more information, see Delete metadata objects.

Version 8.10.0.cl, January 2023🔗

The 8.10.0.cl release version introduces the following features and enhancements:

TML import API

The /tspublic/v1/metadata/tml/import endpoint now supports re-using GUIDs for new objects created during the import if the guid in the imported TML is not being used by any other object on the server.

APIs for Orgs

This release introduces new REST API v1 endpoints and object properties to support Org operations on a multi-tenant cluster.

Org API endpoints

For multi-tenant clusters with Orgs, ThoughtSpot provides new endpoints to allow CRUD operations for Org objects.

For more information, see Org API and Org administration and management via REST API.

Session API endpoints

If the Orgs feature is enabled and Orgs are created on your cluster, the cluster administrators can use the /tspublic/v1/session/orgs to Switch between Orgs.

For deployments with the trusted authentication framework, you can use the /tspublic/v1/session/auth/token API endpoint lets you create a user just-in-time and dynamically assign Orgs, groups, and privileges to that user.

Mapping Orgs to users and groups

On multi-tenant clusters with Orgs, the user and group API endpoints allow assigning users and groups to an Org object. For more information, refer to the following articles:

Version 8.9.0.cl, November 2022🔗

Session API

Starting from 8.9.0.cl, the /tspublic/v1/session/auth/token endpoint includes the autocreate and groups properties to allow administrators to create a user just-in-time and assign groups and privileges to the user when requesting an authentication token from ThoughtSpot.

TML API

In 8.9.0.cl, ThoughtSpot will rebrand the object name pinboard to liveboard in the TML. The TML objects retrieved from ThoughtSpot via /tspublic/v1/metadata/tml/export API endpoint will show the object name as liveboard in the API response.

User API

The POST /tspublic/v1/user/ and PUT /tspublic/v1/user/{userid} API endpoints allow you set the triggeredbyadmin flag to indicate if the user creation or update request is initiated by the ThoughtSpot admin or an external application.

Version 8.8.0.cl, October 2022🔗

The 8.8.0.cl release version introduces the following enhancements to connection API endpoints:

Version 8.7.0.cl, September 2022🔗

The /tspublic/v1/metadata/tml/export API endpoint supports exporting FQNs of TML objects. To export FQNs, you must the export_fqn property to true in your API request.

For more information, see Export TML.

Version 8.6.0.cl, August 2022🔗

The /tspublic/v1/connection/create and /tspublic/v1/connection/update API endpoints support creating and modifying Denodo data connections respectively. For more information, see Data connection APIs.

Version, 8.4.0.cl, June 2022🔗

The /tspublic/v1/pinboarddata endpoint now allows retrieving transient content from a Liveboard. The transient_pinboard_content parameter allows you to add a script to fetch the unsaved changes if any for a given Liveboard.

For more information, see Liveboard data API.

Version 8.2.0.cl, April 2022🔗

New REST API v1 endpoints for data connection queries:

Version 8.1.0.cl, March 2022🔗

Bug fixes and improvements

Version 8.0.0.cl, February 2022🔗

REST clients using Postman for API calls can now send a POST request to the /tspublic/v1/session/auth/token endpoint.
In the earlier releases, unauthenticated clients were not allowed to make an API call to /tspublic/v1/session/auth/token via Postman.

Version ts8.nov.cl, January 2022🔗

New API endpoint for token-based login

POST /tspublic/v1/session/login/token

This API endpoint allows you to make a POST request with parameters in the request body. For more information, see Authenticate and log in a user.

Modified endpoints

  • The /tspublic/v1/connection/create and /tspublic/v1/connection/update endpoints now allow configuring and modifying a connection without importing tables.

    For more information, see Data connection APIs.

  • The authorguid attribute in /tspublic/v1/metadata/list now allows you to filter metadata objects by author GUIDs in API response.

    For more information, see Get a list of metadata objects.

Version ts7.oct.cl, November 2021🔗

New API endpoints

  • POST /tspublic/v1/group/{groupid}/users

  • GET /tspublic/v1/group/{groupid}/users

  • PUT /tspublic/v1/user/email

  • POST /tspublic/v1/user/{userid}/groups

  • GET /tspublic/v1/user/{userid}/groups

  • PUT /tspublic/v1/user/{userid}/groups

  • DELETE /tspublic/v1/user/{userid}/groups

  • DELETE /tspublic/v1/group/{groupid}/users

For more information about these APIs, see REST API Reference.

Version ts7.sep.cl, October 2021🔗

New API endpoints

  • POST /tspublic/v1/connection/create

  • POST /tspublic/v1/connection/update

  • POST /tspublic/v1/connection/export

  • POST /tspublic/v1/connection/delete

  • POST /tspublic/v1/metadata/unassigntag

  • GET /tspublic/v1/metadata/list

  • GET /tspublic/v1/security/metadata/permissions

  • GET /tspublic/v1/security/metadata/{id}/permissions

  • GET /tspublic/v1/security/effectivepermissionbulk

  • GET /tspublic/v1/session/info

  • POST /tspublic/v1/user/activate

  • POST /tspublic/v1/user/inactivate

  • POST /tspublic/v1/user/session/invalidate

  • POST /tspublic/v1/user/resetpassword

  • PUT /tspublic/v1/group/{groupid}/users

  • POST /tspublic/v1/group/{groupid}/groups

  • PUT /tspublic/v1/group/{groupid}/groups

  • GET /tspublic/v1/group/{groupid}/groups

  • POST /tspublic/v1/group/addmemberships

  • POST /tspublic/v1/group/removememberships

  • DELETE /tspublic/v1/group/{groupid}/groups

For more information, see REST API Reference.

Modified API endpoints

POST /tspublic/v1/metadata/assigntag

Version ts7.aug.cl, September 2021🔗

The ThoughtSpot 7 Cloud August release introduces several new API endpoints:

Admin API endpoints

  • POST /tspublic/v1/admin/configinfo/update

  • GET /tspublic/v1/admin/configinfo/overrides

  • GET /tspublic/v1/admin/configinfo

  • GET /tspublic/v1/admin/embed/actions

  • GET /tspublic/v1/admin/embed/actions/{actionid}

  • POST /tspublic/v1/admin/embed/actions

  • DELETE /tspublic/v1/admin/embed/actions/{actionid}

  • PUT /tspublic/v1/admin/embed/actions/{actionid}

  • POST /tspublic/v1/admin/embed/action/{actionid}/associations

  • GET /tspublic/v1/admin/embed/action/{actionid}/associations

  • DELETE /tspublic/v1/admin/embed/action/{actionid}/associations

For more information, see Admin APIs.

Group API endpoints

  • POST /tspublic/v1/group/

  • GET /tspublic/v1/group/

  • PUT /tspublic/v1/group/{groupid}

  • POST /tspublic/v1/group/{groupid}/user/{userid}

  • DELETE /tspublic/v1/group/{groupid}/user/{userid}

  • DELETE /tspublic/v1/group/{groupid}

For more information, see Group APIs.

User API endpoints

  • GET /tspublic/v1/user/

  • POST /tspublic/v1/user/

  • DELETE /tspublic/v1/user/{userid}

  • PUT /tspublic/v1/user/{userid}

For more information, see user APIs.

Dependency API endpoints

  • `POST /tspublic/v1/dependency/listdependents

  • GET /tspublic/v1/dependency/listincomplete

  • POST /tspublic/v1/dependency/listdependents

  • GET /tspublic/v1/dependency/physicaltable

  • GET /tspublic/v1/dependency/pinboard

  • GET /tspublic/v1/dependency/logicalcolumn

  • GET /tspublic/v1/dependency/logicaltable

  • GET /tspublic/v1/dependency/logicalrelationship

  • GET /tspublic/v1/dependency/physicalcolumn

For more information, see Dependent objects APIs.

Connection API endpoints

  • GET /tspublic/v1/connection/types

  • GET /tspublic/v1/connection/list

For more information, see Connection APIs.

Log API endpoint

GET /tspublic/v1/logs/topics/{topic} For more information, see Audit logs API.

Version ts7.jun.cl, July 2021🔗

New API endpoints

  • POST /tspublic/v1/security/share

  • POST /tspublic/v1/security/shareviz

  • GET /tspublic/v1/session/login/token

  • POST /tspublic/v1/metadata/assigntag

  • GET /tspublic/v1/metadata/details

  • POST /tspublic/v1/metadata/markunmarkfavoritefor

  • DELETE /tspublic/v1/metadata/markunmarkfavoritefor

  • POST /tspublic/v1/session/homepinboard

  • GET /tspublic/v1/session/homepinboard

  • DELETE /tspublic/v1/session/homepinboard

For more information, see REST API Reference.

Other enhancements

The POST /tspublic/v1/user/updatepreference API now includes the optional username parameter. You can use either userid or username in your API request.

For more information, see Update a user profile.

Version ts7.may.cl, June 2021🔗

New endpoints

  • POST /tspublic/v1/user/updatepreference

  • GET /tspublic/v1/metadata/listas