---
schema_version: "1"
id: 63373b71169075804989da3c0993ce1c67144c94e4c7aa7dacacabec7e7c6e72
title: Ask Data Lens Methods - Retired
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/api/rest_api/REST/rest_api_ref_ask_data_lens.md
canonical_url: https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_ask_data_lens.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 030fc57461fc43a224feb46f6ad83f1cb903f712a2e2c76ff19f085551a268d1
description: Important changes for Ask Data and Metrics Tableau's Ask Data and Metrics features were retired in Tableau Cloud in February 2024 and in Tableau Server version 2024
---
[Skip to main content](#main-content)

# Ask Data Lens Methods - Retired

* * *

## Retired in API 3.22 (Cloud February 2024 / Server 2024.2)

> > [!WARNING]
> > 
> > **Important changes for Ask Data and Metrics**  
> > Tableau's Ask Data and Metrics features were retired in Tableau Cloud in February 2024 and in Tableau Server version 2024.2. With advances in natural language technologies, we're developing an improved interface that will make it easier to ask questions of your data and stay on top of changes. For more information, see [How Tableau GPT and Tableau Pulse are reimagining the data experience](https://www.tableau.com/blog/tableau-pulse-and-tableau-gpt).

* * *

* * *

Ask data lenses enable you to refine the way a user's natural language query is interpreted, based on the specific audience they belong to.

For instance, you might make one lens for medical staff at a hospital, and another for administrative staff. A lens allows you to define synonyms to associate key words with common terms used for them. For instance, "SF" for "San Francisco", or "Rx" for "prescription". You can also configure recommended visualizations for each lens.

> Introduced: Tableau Cloud June 2022. Not currently available for Tableau Server.
> 
> Using the Tableau REST API, you can:
> 
> - Create a lens and configure its properties
> - Delete a lens
> - Import an existing lens
> - Get a list of lenses on a site or the details of a specified lens

## Use Postman

Our Postman collection of requests enables you to construct, send, and examine HTTP requests to the Tableau Server or Tableau Cloud API without writing initial code. Postman is a free online app used by many developers for prototyping API calls, investigating issues, and generating request code in a variety of languages.  
Postman: [Ask Data Lens Methods - Retired](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/folder/12721794-42ceab2a-996a-4466-a9b7-aa8e5239d560)

## Create ask data lens - Retired in API 3.22

* * *

Retired in API 3.22 (Cloud February 2024 / Server 2024.2)

> > [!WARNING]
> > 
> > **Important changes for Ask Data and Metrics**  
> > Tableau's Ask Data and Metrics features were retired in Tableau Cloud in February 2024 and in Tableau Server version 2024.2. With advances in natural language technologies, we're developing an improved interface that will make it easier to ask questions of your data and stay on top of changes. For more information, see [How Tableau GPT and Tableau Pulse are reimagining the data experience](https://www.tableau.com/blog/tableau-pulse-and-tableau-gpt).

* * *

Create an ask data lens.

**Version:** Available in API 3.16 ( Tableau Cloud June 2022 / Server 2022.3) and later. [Version Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** This method can be called by users who have Create permissions for lenses on the site. [Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** No additional license required.

**Access Scope:** \`tableau:lenses:create\` [Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/-/askdata/lenses

[view details](#)

## Delete ask data lens - Retired in API 3.22

* * *

Retired in API 3.22 (Cloud February 2024 / Server 2024.2)

> > [!WARNING]
> > 
> > **Important changes for Ask Data and Metrics**  
> > Tableau's Ask Data and Metrics features were retired in Tableau Cloud in February 2024 and in Tableau Server version 2024.2. With advances in natural language technologies, we're developing an improved interface that will make it easier to ask questions of your data and stay on top of changes. For more information, see [How Tableau GPT and Tableau Pulse are reimagining the data experience](https://www.tableau.com/blog/tableau-pulse-and-tableau-gpt).

* * *

Delete an ask data lens.

**Version:** Available in API 3.16 ( Tableau Cloud June 2022 / Server 2022.3) and later. [Version Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** This method can be called by users with administrator and lens owner permissions. [Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** No additional license required.

**Access Scope:** \`tableau:lenses:delete\` [Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

DELETE {server}/api/-/askdata/lenses/{lens\_id}

[view details](#)

## Get ask data lens - Retired in API 3.22

* * *

Retired in API 3.22 (Cloud February 2024 / Server 2024.2)

> > [!WARNING]
> > 
> > **Important changes for Ask Data and Metrics**  
> > Tableau's Ask Data and Metrics features were retired in Tableau Cloud in February 2024 and in Tableau Server version 2024.2. With advances in natural language technologies, we're developing an improved interface that will make it easier to ask questions of your data and stay on top of changes. For more information, see [How Tableau GPT and Tableau Pulse are reimagining the data experience](https://www.tableau.com/blog/tableau-pulse-and-tableau-gpt).

* * *

Get the details of the specified ask data lens.

**Version:** Available in API 3.16 ( Tableau Cloud June 2022 / Server 2022.3) and later. [Version Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** This method can be called by users who have Read access to the lens. [Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** No additional license required.

**Access Scope:** \`tableau:lenses:read\` [Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

GET {server}/api/-/askdata/lenses/{lens\_id}

[view details](#)

## Import ask data lens - Retired in API 3.22

* * *

Retired in API 3.22 (Cloud February 2024 / Server 2024.2)

> > [!WARNING]
> > 
> > **Important changes for Ask Data and Metrics**  
> > Tableau's Ask Data and Metrics features were retired in Tableau Cloud in February 2024 and in Tableau Server version 2024.2. With advances in natural language technologies, we're developing an improved interface that will make it easier to ask questions of your data and stay on top of changes. For more information, see [How Tableau GPT and Tableau Pulse are reimagining the data experience](https://www.tableau.com/blog/tableau-pulse-and-tableau-gpt).

* * *

Import an existing ask data lens on a server to a site, and optionally transform the metadata of the lens in the process.

**Version:** Available in API 3.16 ( Tableau Cloud June 2022 / Server 2022.3) and later. [Version Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** This method can only be called by server administrators or site administrators. [Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** No additional license required.

**Access Scope:** \`tableau:lenses:create\` [Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/-/askdata/lenses/import

[view details](#)

## List ask data lenses in site - Retired in API 3.22

* * *

Retired in API 3.22 (Cloud February 2024 / Server 2024.2)

> > [!WARNING]
> > 
> > **Important changes for Ask Data and Metrics**  
> > Tableau's Ask Data and Metrics features were retired in Tableau Cloud in February 2024 and in Tableau Server version 2024.2. With advances in natural language technologies, we're developing an improved interface that will make it easier to ask questions of your data and stay on top of changes. For more information, see [How Tableau GPT and Tableau Pulse are reimagining the data experience](https://www.tableau.com/blog/tableau-pulse-and-tableau-gpt).

* * *

Returns a list of ask data lenses in a site.

**Version:** Available in API 3.16 ( Tableau Cloud June 2022 / Server 2022.3) and later. [Version Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** This method can be called by any user. Responses will include only the lenses to the user has access to. [Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** No additional license required.

**Access Scope:** \`tableau:lenses:read\` [Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

GET {server}/api/-/askdata/lenses

[view details](#)