Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Get Dataset Health Checks

GET/api/v2/datasets/{datasetRid}/getHealthChecks
Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Get the RIDs of the Data Health Checks that are configured for the given Dataset.

Third-party applications using this endpoint via OAuth2 must request the following operation scopes: api:data-health-read api:datasets-read.

Path parameters

datasetRid
string

The Resource Identifier (RID) of a Dataset.

Query parameters

branchName
string
optional

The name of the Branch. If none is provided, the default Branch name - master for most enrollments - will be used.

preview
boolean
optional

Enables the use of preview functionality.

Response body

ListHealthChecksResponse
object
Hide child attributes

Hide child attributes

data
list<CheckRid>
optional
Show child attributes

Show child attributes

Examples

Request

Copied!
1 2 3 curl \ \t-H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v2/datasets/ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da/getHealthChecks?branchName=master&preview=true"

Response

Copied!
1 2 3 4 5 { "data": [ "ri.data-health.main.check.8e27b13a-e21b-4232-ae1b-76ccf5ff42b3" ] }

Error responses

Error Name
BranchNotFoundError CodeNOT_FOUND
Status Code404
DescriptionThe requested branch could not be found, or the client token does not have access to it.
ParametersdatasetRid, branchName
DatasetNotFoundError CodeNOT_FOUND
Status Code404
DescriptionThe requested dataset could not be found, or the client token does not have access to it.
ParametersdatasetRid
GetDatasetHealthChecksPermissionDeniedError CodePERMISSION_DENIED
Status Code403
DescriptionCould not getHealthChecks the Dataset.
ParametersdatasetRid