---
schema_version: "1"
id: 2d97286cf227339d98d397219efb079e393fdd49c298ffeac18c415ccded3af4
title: Release Notes
collection: tableau
version: next
locale: en-us
portal_url: https://docs.salesforce.com/tableau/next/en-us/api/metadata_api/docs/meta_api_release_notes.md
canonical_url: https://help.tableau.com/v0.0/api/metadata_api/en-us/docs/meta_api_release_notes.html
source_site: help.tableau.com
content_type: documentation
content_hash: 63fcc3fc693c31c94f141d5723e5224093e56047ca1236f8bf73951e6c0aa19f
description: Documentation for the Tableau Metadata API
---
# Release Notes

  

Significant changes to this project are noted in this document.

**Jump to version**

### Tableau Cloud June 2024 / Server 2024.2

#### Added

- Added Tableau Pulse MetricDefinition objects and supporting shortcuts to the schema.
- Tableau Server: Lens objects and supporting shortcuts are retired. No lens or lens properties are returned from queries. (Removed from Tableau Server in this version. Already removed from Tableau Cloud in February 2023.)
- Tableau Server: Metrics objects and supporting shortcuts are retired. No metrics or metrics properties are returned from queries. (Removed from Tableau Server in this version. Already removed from Tableau Cloud in February 2023.)

### Tableau Cloud February 2024

#### Retired

- Lens objects and supporting shortcuts are retired. No lens or lens properties are returned from queries.
- Metrics objects and supporting shortcuts are retired. No metrics or metrics properties are returned from queries.

### Tableau Cloud October 2023 / Server 2023.3

#### Added

- Tableau Server: Added Metadata API request throttling. Requests that exceed the rate threshold receive a RATE\_EXCEEDED error. (New for Tableau Server in this version. Already added to Tableau Cloud in June 2023.)
- The Metadata API now respects credentials tokens that were obtained via a JSON web token (JWT) and Tableau connected apps. You still use the REST API Sign In method to get a credentials token, but now you can use a JWT in the REST API Sign In request. For information, see [Sign in using a JSON web token (JWT)](https://help.tableau.com/v0.0/api/metadata_api/en-us/docs/meta_api_auth.html#metadata-api-auth-json).

### Tableau Cloud June 2023

#### Added

- Added Metadata API request throttling. Requests that exceed the rate threshold receive a RATE\_EXCEEDED error.
- Types that implement the Field interface can be filtered by name using a text filter. The filter will return fields where any word in the field name begins with the specified case-insensitive text.

Example:

query FilteredFields {
    publishedDatasources {
        name
        fields (filter: {text: "age"}) {
            id
            name
        }
    }
}

### Tableau Cloud March 2023 / Server 2023.1

#### Changed

- The virtualConnection object’s connectionType attribute now returns ‘null’, and may be removed in a future release. Use ‘connectionType’ of ‘upstreamDatabases’ instead. (New for Tableau Server 2023.1. Changed in Tableau Cloud in December 2022)
- The DataQualityWarning.asset and DataQualityCertification.asset edges now point to the CanHaveLabels interface instead of the Warnable and Certifiable interfaces. This change was made to move the schema towards a more general interface that works with all labels. Referencing edge names that exist on the Warnable and Certificable interfaces but do not exist on the CanHaveLabels interface will produce an error. For information on the error and adjusting queries that may be affected, see “Other Errors”, in the [Common Errors](https://help.tableau.com/v0.0/api/metadata_api/en-us/docs/meta_api_errors.html#other-errors) topic. The list of affected edges is:
    - Warnable.hasActiveWarning
    - Warnable.dataQualityWarnings
    - Warnable.dataQualityWarningsConnection
    - Certifiable.isCertified
    - Certifiable.dataQualityCertifications
    - Certifiable.dataQualityCertificationsConnection

### Tableau Cloud December 2022

#### Changed

- The virtualConnection object’s connectionType attribute now returns ‘null’, and may be removed in a future release. Use ‘connectionType’ of ‘upstreamDatabases’ instead.

### Tableau Cloud October 2022 / Server 2022.3

#### Added

- Modified existing data quality warning shortcuts to support data quality warnings on columns.

### Tableau Cloud June 2022

#### Added

- Added lens objects and supporting shortcuts to the schema.
- Added new fields to existing objects:
    
    | Object | New fields |
    | --- | --- |
    | tableauSites | createdAt |
    | workbooks | projectLuid |
    | datasources | createdAt, updatedAt |
    | flows | createdAt, updatedAt |
    | virtualConnections | createdAt, updatedAt |

### Tableau Cloud March 2022 / Server 2022.1

#### Added

- Added the virtualConnection and virtualConnectionTable objects and supporting shortcuts to the schema.

### Tableau Cloud December 2021 / Server 2021.4

#### Changed

- Some shortcuts were changed to make the definitions of “upstream” and “downstream” more consistent throughout the schema.
    - The `Column` type’s `upstreamTables` and `downstreamTables` shortcuts no longer include the table that contains the column. Use `Column.table` to find information about the containing table instead.
    - The `Table` type’s `upstreamDatabases` shortcut no longer includes the database that contains the table. Use `... on DatabaseTable {database}` instead.
    - The `Workbook` type’s `downstreamOwners` field no longer includes the owner of the workbook. Use `Workbook.owner` to find information about the workbook owner instead.

### Older versions

The Metadata API was officially released in Tableau Server 2019.3 and Tableau Cloud in September of 2019. This document tracks Metadata API changes starting with 2021.4.