> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.select.dev/llms.txt > Use this file to discover all available pages before exploring further. # Update a Tableau connection ## OpenAPI ````yaml https://api.select.dev/v2/openapi.json patch /tableau-connections/{tableau_connection_id} openapi: 3.1.0 info: title: SELECT API (v2) version: 0.1.0 servers: - url: https://api.select.dev/v2 description: SELECT API v2 security: [] paths: /tableau-connections/{tableau_connection_id}: patch: tags: - tableau-connections summary: Update a Tableau connection operationId: >- update_tableau_connection_route_tableau_connections__tableau_connection_id__patch parameters: - name: tableau_connection_id in: path required: true schema: type: string title: Tableau Connection Id - name: If-Match in: header required: false schema: anyOf: - type: string - type: 'null' title: If-Match - name: x-tenant-id in: header required: true schema: type: string description: The organization ID the request is scoped to. title: X-Tenant-Id description: The organization ID the request is scoped to. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TableauConnectionUpdate' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TableauConnection' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '405': $ref: '#/components/responses/MethodNotAllowed' '408': $ref: '#/components/responses/RequestTimeout' '409': $ref: '#/components/responses/Conflict' '412': $ref: '#/components/responses/PreconditionFailed' '422': $ref: '#/components/responses/ValidationFailed' '428': $ref: '#/components/responses/PreconditionRequired' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/ServiceUnavailable' security: - HTTPBearer: [] components: schemas: TableauConnectionUpdate: properties: name: anyOf: - type: string minLength: 1 - type: 'null' title: Name description: Display name for the connection, as shown throughout SELECT. server_url: anyOf: - type: string - type: 'null' title: Server Url description: >- Base URL of the Tableau deployment to connect to, including the scheme and without a site path. site_name: anyOf: - type: string minLength: 1 - type: 'null' title: Site Name description: The site on that deployment to read, by its URL name. credentials: anyOf: - $ref: '#/components/schemas/TableauCredentials' - type: 'null' description: >- The personal access token SELECT authenticates with. Revalidated against Tableau before it is stored. sync_enabled: anyOf: - type: boolean - type: 'null' title: Sync Enabled description: Whether SELECT is currently syncing data for this connection. query_sanitization_enabled: anyOf: - type: boolean - type: 'null' title: Query Sanitization Enabled description: Whether query text is sanitized before SELECT stores it. type: object title: TableauConnectionUpdate description: >- A merge-patch update to an existing connection. Omitted fields are left unchanged; `null` clears a field. Mirrors `TableauConnectionCreate`. Every field is required when present and cannot be cleared with `null`. A connection stays pointed at the site it was added for. `server_url` and `site_name` may be corrected, but the change is rejected if the corrected pair resolves to a different site — add a second connection for that site instead. Rotating credentials is atomic: the token name and secret move together, since `TableauCredentials` requires both. TableauConnection: properties: id: type: string title: Id description: The unique identifier of the connection. readOnly: true x-terraform-computed: true etag: type: string title: Etag description: >- Opaque strong ETag for this connection's configuration. Matches the `ETag` response header, and is what `If-Match` requires on a write. It changes whenever a configurable field on the connection changes. readOnly: true x-terraform-computed: true name: type: string title: Name description: Display name for the connection, as shown throughout SELECT. connection_id: type: string title: Connection Id description: >- Identifier of the connection resource this Tableau connection belongs to (see `GET /v2/connections/{connection_id}`). Distinct from `id`, which identifies this Tableau connection specifically. readOnly: true x-terraform-computed: true server_url: type: string title: Server Url description: >- Base URL of the Tableau deployment SELECT connects to, without a site path — for example `https://us-east-1.online.tableau.com`. site_name: type: string title: Site Name description: >- The site on that deployment SELECT reads. This is the site's URL name, which is what Tableau signs in against; `Default` names the default site of a Tableau Server deployment. site_luid: type: string title: Site Luid description: >- The identifier Tableau assigns the site, resolved when the connection is added. Unlike `site_name` it survives a rename, so it is what SELECT keys the site's data and access rules on. readOnly: true x-terraform-computed: true sync_enabled: type: boolean title: Sync Enabled description: Whether SELECT is currently syncing data for this connection. query_sanitization_enabled: type: boolean title: Query Sanitization Enabled description: Whether query text is sanitized before SELECT stores it. added_by_email: anyOf: - type: string - type: 'null' title: Added By Email description: >- Email address of the person who added the connection. Null when it was not added by a person. readOnly: true x-doit-confidentiality: customer-data x-doit-pii: true x-terraform-computed: true last_successful_sync_time: anyOf: - type: string - type: 'null' title: Last Successful Sync Time description: >- When SELECT last completed a sync for this connection. Null before the first one succeeds. readOnly: true x-terraform-computed: true create_time: type: string title: Create Time description: When the connection was added. readOnly: true x-terraform-computed: true update_time: type: string title: Update Time description: When the connection was last changed. readOnly: true x-terraform-computed: true type: object required: - id - etag - name - connection_id - server_url - site_name - site_luid - sync_enabled - query_sanitization_enabled - create_time - update_time title: TableauConnection description: A connection to one Tableau site. TableauCredentials: properties: personal_access_token_name: type: string minLength: 1 title: Personal Access Token Name description: Name of the personal access token SELECT authenticates with. personal_access_token_secret: type: string minLength: 1 title: Personal Access Token Secret description: The secret Tableau issued when that token was created. writeOnly: true x-doit-confidentiality: sensitive x-terraform-sensitive: true type: object required: - personal_access_token_name - personal_access_token_secret title: TableauCredentials description: >- How SELECT authenticates to a Tableau site. A personal access token. Create it on a Tableau user with access to the site SELECT should read; SELECT reads nothing that user cannot. The name and the secret are one credential and are always supplied together: a Tableau user can hold several tokens, so the name selects which one and the secret proves it. Supplying a name without its own secret authenticates as neither. ProblemDetail: additionalProperties: true description: >- RFC 9457-style error payload, served as ``application/problem+json``. ``code`` is the stable, machine-readable identifier — consumers branch on it, never on ``title``. ``type`` stays ``about:blank``: we keep no per-error documentation pages. There is no ``instance``/request-id member (we don't run access logs). See the flat error-code catalogue in §4 of the standards doc. properties: type: default: about:blank title: Type type: string title: type: string title: Title status: title: Status type: integer detail: title: Detail type: string code: title: Code type: string retryable: title: Retryable type: boolean details: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' default: null title: Details required: - title - status - detail - code - retryable title: ProblemDetail type: object responses: BadRequest: description: Bad request content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' Unauthorized: description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' headers: WWW-Authenticate: description: Authentication challenge for the requested resource. required: true schema: type: string Forbidden: description: Forbidden content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' NotFound: description: Not found content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' MethodNotAllowed: description: Method not allowed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' headers: Allow: description: HTTP methods supported by the requested resource. required: true schema: type: string RequestTimeout: description: Request Timeout content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' Conflict: description: Conflict content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' PreconditionFailed: description: Precondition failed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' ValidationFailed: description: Validation failed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' PreconditionRequired: description: Precondition required content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' RateLimited: description: Rate limited content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' headers: Retry-After: description: Number of seconds to wait before retrying the request. required: true schema: type: integer minimum: 0 InternalError: description: Internal error content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' ServiceUnavailable: description: Service unavailable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' headers: Retry-After: description: Number of seconds to wait before retrying the request. required: true schema: type: integer minimum: 0 securitySchemes: HTTPBearer: type: http description: Organization API key (sl_…). scheme: bearer ````