Logo
MicroStrategy REST API API Documentation

Get the definition of a dataset

GET {{baseUrl}}/api/datasets/:datasetId

Get the definition of a specific MTDI dataset; this can be either a single-table dataset or a dataset with multiple tables. You obtain the authorization token needed to execute the request using POST /auth/login; you obtain the project ID using GET /projects. You pass the authorization token and the project ID in the request header. You specify the dataset ID in the path of the request; you obtain the dataset ID from POST /datasets or POST /datasets/models. You specify the kind of data to return using the 'fields' query parameter in the request; possible values include tables, columns, attributes, and metrics. You can specify multiple values for the 'fields' parameter by adding each value in a new line in the 'fields' value textbox; if you don't specify any value, attributes and metrics will be returned.

 

Body PARAM

Key Datatype Required Description 
fields
null Specifies object types to be returned. Possible values include tables, columns, attributes, and metrics. If no value is set, attributes and metrics are returned.



HEADERS

Key Datatype Required Description 
X-MSTR-AuthToken
string (Required) Authorization token
X-MSTR-ProjectID
string (Required) Project ID




RESPONSES

status





Curl
curl -X GET 'baseUrl/api/datasets/:datasetId?fields=' -H 'X-MSTR-AuthToken: authToken' -H 'X-MSTR-ProjectID: projectId'

ENDPOINTS