ThoughtSpot

ThoughtSpot Manual Translation API

The Manual Translation API from ThoughtSpot — 4 operation(s) for manual translation.

GitHub OpenAPI

Operations 4

POST /api/rest/2.0/localizations/manual-translation/delete Delete manual translations #
POST /api/rest/2.0/localizations/manual-translation/export Export manual translations #
POST /api/rest/2.0/localizations/manual-translation/locales/{locale}/export Get manual translation bundle #
POST /api/rest/2.0/localizations/manual-translation/import Import manual translations #

Documentation

📖
Documentation
https://developers.thoughtspot.com/docs/rest-apiv2-reference
📖
GettingStarted
https://developers.thoughtspot.com/docs/rest-api-getstarted
📖
Authentication
https://artifacts.apis.io/thoughtspot/authentication/thoughtspot-authentication.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/thoughtspot/openapi/thoughtspot-manual-translation-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://artifacts.apis.io/thoughtspot/errors/thoughtspot-problem-types.yml
🔗
Conventions
https://artifacts.apis.io/thoughtspot/conventions/thoughtspot-conventions.yml
🔗
Idempotency
https://artifacts.apis.io/thoughtspot/conventions/thoughtspot-conventions.yml
🔗
DataModel
https://artifacts.apis.io/thoughtspot/data-model/thoughtspot-data-model.yml
🔗
Conformance
https://artifacts.apis.io/thoughtspot/conformance/thoughtspot-conformance.yml
🔗
AgenticAccess
https://artifacts.apis.io/thoughtspot/agentic-access/thoughtspot-agentic-access.yml
🔗
Webhooks
https://artifacts.apis.io/thoughtspot/asyncapi/thoughtspot-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/thoughtspot:thoughtspot-manual-translation-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

thoughtspot-manual-translation-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ThoughtSpot Public REST Manual Translation API
  version: '2.0'
servers:
- url: '{base-url}'
  variables:
    base-url:
      default: https://localhost:443
security:
- bearerAuth: []
tags:
- name: Manual Translation
paths:
  /api/rest/2.0/localizations/manual-translation/delete:
    post:
      operationId: deleteManualTranslations
      description: 'Delete manual translations.

        Version: 26.7.0.cl or later


        Deletes all manual translations for the org.


        Requires `ADMINISTRATION` (**Can administer ThoughtSpot**), `ORG_ADMINISTRATION` (**Can administer Org**), or `APPLICATION_ADMINISTRATION` (**Can administer application**) privilege.


        #### Usage guidelines


        - This deletes **all** translation entries for the targeted org. The operation cannot be undone.

        - Defaults to `ORG` scope if not specified.

        - Set `scope` to `CLUSTER` to delete translations uploaded in the All-Org context.


        #### Endpoint URL'
      tags:
      - Manual Translation
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteManualTranslationsRequest'
        required: true
      parameters: []
      responses:
        '204':
          description: Successfully deleted manual translations.
        '400':
          description: Operation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Operation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Delete manual translations
      x-summary-source: derived
  /api/rest/2.0/localizations/manual-translation/export:
    post:
      operationId: exportManualTranslations
      description: 'Export manual translations as a CSV file.

        Version: 26.7.0.cl or later


        Downloads all manual translations for the org as a CSV file.


        Requires `ADMINISTRATION` (**Can administer ThoughtSpot**), `ORG_ADMINISTRATION` (**Can administer Org**), or `APPLICATION_ADMINISTRATION` (**Can administer application**) privilege.


        #### Usage guidelines


        - The response is a CSV file with columns: `content`, `locale`, `translated-content`.

        - Defaults to `ORG` scope if not specified.

        - Set `scope` to `CLUSTER` to export translations from the All-Org context.

        - Returns a `404` error if no translations exist for the targeted org or cluster scope.


        #### Endpoint URL'
      tags:
      - Manual Translation
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportManualTranslationsRequest'
        required: true
      parameters: []
      responses:
        '200':
          description: CSV file downloaded successfully.
          content:
            application/octet-stream: {}
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: No translations file found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Export manual translations
      x-summary-source: derived
  /api/rest/2.0/localizations/manual-translation/locales/{locale}/export:
    post:
      operationId: getManualTranslationBundle
      description: 'Get translations bundle for a locale.

        Version: 26.7.0.cl or later


        Retrieves all translations for a specific locale as a JSON map.


        Available to all authenticated users. No additional privileges are required.


        #### Usage guidelines


        - `locale` parameter must be a hyphenated locale code (for example, `fr-fr`, `de-de`, `JA-JP`).

        - Returns a JSON object with a `translations` map where each key is the original string and each value is the translated string.

        - If the org has no translations for the requested locale, the endpoint falls back to cluster-level translations.

        - Returns an empty `translations` map (not an error) if no entries exist at either level.


        #### Endpoint URL'
      tags:
      - Manual Translation
      parameters:
      - in: path
        name: locale
        required: true
        schema:
          type: string
        description: Locale code for which to retrieve translations.  For example, `fr-fr`, `de-de`, `JA-JP`.
      responses:
        '200':
          description: Translation bundle retrieved successfully.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: No translations found for the requested locale.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Get manual translation bundle
      x-summary-source: derived
  /api/rest/2.0/localizations/manual-translation/import:
    post:
      operationId: importManualTranslations
      description: 'Import manual translations from a CSV file.

        Version: 26.7.0.cl or later


        Uploads a CSV file containing manual translations and upserts them into the database.


        Requires `ADMINISTRATION` (**Can administer ThoughtSpot**), `ORG_ADMINISTRATION` (**Can administer Org**), or `APPLICATION_ADMINISTRATION` (**Can administer application**) privilege.


        #### Usage guidelines


        - The CSV file must have exactly three columns in this order: `content`, `locale`, `translated-content`.

        - Maximum file size: **30 MB**. Maximum rows: **10,000**.

        - Only `.csv` files are accepted.

        - The import performs an **upsert**: existing entries matched by `(org_id, locale, content)` are updated; new entries are inserted. Entries not in the upload are left untouched.

        - Set `scope` to `CLUSTER` to upload translations to the All-Org context. Cluster-level translations act as defaults for orgs that have no translations for a locale.


        #### Endpoint URL'
      tags:
      - Manual Translation
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                translations_file:
                  description: 'CSV file containing translations. The file must have three columns:

                    `content`, `locale`, `translated-content`. Max file size: 30 MB.

                    Max rows: 10,000.'
                  type: string
                  format: binary
                scope:
                  description: 'Org scope for the import. `ORG` (default) targets the calling

                    user''s current org. `CLUSTER` targets the All-Org context.'
                  default: ORG
                  type: string
                  enum:
                  - ORG
                  - CLUSTER
              required:
              - translations_file
        required: true
      parameters: []
      responses:
        '204':
          description: Successfully imported manual translations.
        '400':
          description: Operation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Operation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Import manual translations
      x-summary-source: derived
components:
  schemas:
    DeleteManualTranslationsRequest:
      type: object
      properties:
        scope:
          description: 'Org scope for the delete. `ORG` (default) targets the calling

            user''s current org. `CLUSTER` targets the All-Org context.'
          default: ORG
          type: string
          enum:
          - ORG
          - CLUSTER
    ExportManualTranslationsRequest:
      type: object
      properties:
        scope:
          description: 'Org scope for the export. `ORG` (default) targets the calling

            user''s current org. `CLUSTER` targets the All-Org context.'
          default: ORG
          type: string
          enum:
          - ORG
          - CLUSTER
    ErrorResponse:
      type: object
      properties:
        error:
          type:
          - object
          - 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
x-roles:
- name: 26.2.0.cl
  id: 26.2.0.cl
  tags:
  - 26.2.0.cl
  description: Roles for version 26.2.0.cl
- name: 10.4.0.cl
  id: 10.4.0.cl
  tags:
  - 10.4.0.cl
  description: Roles for version 10.4.0.cl
- name: 26.7.0.cl
  id: 26.7.0.cl
  tags:
  - 26.7.0.cl
  description: Roles for version 26.7.0.cl
- name: 26.8.0.cl
  id: 26.8.0.cl
  tags:
  - 26.8.0.cl
  description: Roles for version 26.8.0.cl
- name: 26.6.0.cl
  id: 26.6.0.cl
  tags:
  - 26.6.0.cl
  description: Roles for version 26.6.0.cl
- name: 10.15.0.cl
  id: 10.15.0.cl
  tags:
  - 10.15.0.cl
  description: Roles for version 10.15.0.cl
- name: 10.13.0.cl
  id: 10.13.0.cl
  tags:
  - 10.13.0.cl
  description: Roles for version 10.13.0.cl
- name: 26.9.0.cl
  id: 26.9.0.cl
  tags:
  - 26.9.0.cl
  description: Roles for version 26.9.0.cl
- name: 10.7.0.cl
  id: 10.7.0.cl
  tags:
  - 10.7.0.cl
  description: Roles for version 10.7.0.cl
- name: 26.5.0.cl
  id: 26.5.0.cl
  tags:
  - 26.5.0.cl
  description: Roles for version 26.5.0.cl
- name: 9.0.0.cl
  id: 9.0.0.cl
  tags:
  - 9.0.0.cl
  description: Roles for version 9.0.0.cl
- name: 9.4.0.cl
  id: 9.4.0.cl
  tags:
  - 9.4.0.cl
  description: Roles for version 9.4.0.cl
- name: 9.12.0.cl
  id: 9.12.0.cl
  tags:
  - 9.12.0.cl
  description: Roles for version 9.12.0.cl
- name: 26.4.0.cl
  id: 26.4.0.cl
  tags:
  - 26.4.0.cl
  description: Roles for version 26.4.0.cl
- name: 10.12.0.cl
  id: 10.12.0.cl
  tags:
  - 10.12.0.cl
  description: Roles for version 10.12.0.cl
- name: 9.2.0.cl
  id: 9.2.0.cl
  tags:
  - 9.2.0.cl
  description: Roles for version 9.2.0.cl
- name: 9.9.0.cl
  id: 9.9.0.cl
  tags:
  - 9.9.0.cl
  description: Roles for version 9.9.0.cl
- name: 9.6.0.cl
  id: 9.6.0.cl
  tags:
  - 9.6.0.cl
  description: Roles for version 9.6.0.cl
- name: 10.10.0.cl
  id: 10.10.0.cl
  tags:
  - 10.10.0.cl
  description: Roles for version 10.10.0.cl
- name: 10.6.0.cl
  id: 10.6.0.cl
  tags:
  - 10.6.0.cl
  description: Roles for version 10.6.0.cl
- name: 10.3.0.cl
  id: 10.3.0.cl
  tags:
  - 10.3.0.cl
  description: Roles for version 10.3.0.cl
- name: 10.1.0.cl
  id: 10.1.0.cl
  tags:
  - 10.1.0.cl
  description: Roles for version 10.1.0.cl
- name: 10.9.0.cl
  id: 10.9.0.cl
  tags:
  - 10.9.0.cl
  description: Roles for version 10.9.0.cl
- name: 10.8.0.cl
  id: 10.8.0.cl
  tags:
  - 10.8.0.cl
  description: Roles for version 10.8.0.cl
- name: 9.5.0.cl
  id: 9.5.0.cl
  tags:
  - 9.5.0.cl
  description: Roles for version 9.5.0.cl
- name: 26.3.0.cl
  id: 26.3.0.cl
  tags:
  - 26.3.0.cl
  description: Roles for version 26.3.0.cl
- name: 10.14.0.cl
  id: 10.14.0.cl
  tags:
  - 10.14.0.cl
  description: Roles for version 10.14.0.cl
- name: 9.7.0.cl
  id: 9.7.0.cl
  tags:
  - 9.7.0.cl
  description: Roles for version 9.7.0.cl