Skip to main content
GET
/
v2
/
team
/
datasets
/
{id}
/
status
Get status summary of data sources in dataset
curl --request GET \
  --url https://ai.data.cloud/api/v2/team/datasets/{id}/status \
  --header 'x-pd-api-key: <api-key>'
{
  "code": 0,
  "data": {
    "synched_count": 5,
    "invalid_count": 0,
    "synching_count": 0
  }
}
This endpoint returns the count of data sources for each status in the specified dataset. You can use it to verify if all data sources are synchronized and ready for running data analysis jobs. If both invalid_count and synching_count in the response are 0, all data sources in the dataset are accessible to Powerdrill for answering questions. Otherwise, any unsynchronized data sources cannot be accessed. Example request: 
curl --request GET \
  --url https://ai.data.cloud/api/v2/team/datasets/{id}/status?user_id=tmm-dafasdfasdfasdf \
  --header 'x-pd-api-key: <api-key>'
Example response:
200
{
  "code": 0,
  "data": {
    "synched_count": 5,
    "invalid_count": 0,
    "synching_count": 0
  }
}

Authorizations

​
x-pd-api-key
string
header
required

Headers

​
x-pd-external-trace-id
string

The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.

Path Parameters

​
id
string
required

The ID of the dataset for which you want to check the status of data sources.

Query Parameters

​
user_id
string
required

Your user ID, which uniquely identifies you within your team. To obtain your ID:

Response

200 - application/json
​
code
integer
required

Status code. 0 indicates that the operation is successful. Otherwise, the operation fails. For error troubleshooting, refer to Error Codes.

​
data
object
required

The number of data sources per state.

Note that only when both invalid_count and synching_count are 0, all data sources in the dataset can be used by Powerdrill to answer your questions. Otherwise, starting a job immediately cannot fetching data from data sources that are not synchronized.