VizQL Data Service (1.0)

Download OpenAPI specification:Download

An API to query Tableau published data sources

Request data source metadata

Requests metadata for a specific data source. The metadata provides information about the data fields, such as field names, data types, and descriptions.

Authorizations:
XTableauAuth
Request Body schema: application/json
required
object (Datasource)
object (QueryOptions)

Some optional metadata that can be used to adjust the behavior of an endpoint.

Responses

Request samples

Content type
application/json
{
  • "datasource": {
    },
  • "options": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Query data source

Queries a specific data source and returns the resulting data.

Authorizations:
XTableauAuth
Request Body schema: application/json
required
object (Datasource)
required
object (Query)

The query is the fundamental interface to the VizQL Data Service. It holds the specific semantics to perform against the data source. A query consists of an array of fields to query against, and an optional array of filters to apply to the query.

object (QueryDatasourceOptions)

Some optional metadata that can be used to adjust the behavior of an endpoint.

Responses

Request samples

Content type
application/json
{
  • "datasource": {
    },
  • "query": {
    },
  • "options": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Send a simple request

Sends a request that can be used for testing or doing a health check.

Responses

Response samples

Content type
application/json
"string"