Skip to content

アプリケーション内で をクリックすると、お使いのDataRobotバージョンに関する全プラットフォームドキュメントにアクセスできます。

AI Catalog

This page outlines the operations, endpoints, parameters, and example requests and responses for the AI Catalog.

GET /api/v2/catalogItems/

List all catalog items accessible by the user.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/catalogItems/?offset=0&limit=0&initialCacheSize=500 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
offset query integer true Specifies the number of results to skip for pagination.
limit query integer true Sets the maximum number of results returned. Enter 0 to specify no limit.
initialCacheSize query integer true The initial cache size, for Mongo search only.
useCache query string false Sets whether to use the cache, for Mongo search only.
orderBy query string false The attribute sort order applied to the returned catalog list: 'catalogName', 'originalName', 'description', 'created', or 'relevance'. For all options other than 'relevance', prefix the attribute name with a dash to sort in descending order. e.g., orderBy='-catalogName'. Defaults to '-created'.
searchFor query string false A value to search for in the dataset's name, description, tags, column names, categories, and latest errors. The search is case insensitive. If no value is provided, or if the empty string is used, or if the string contains only whitespace, no filtering occurs. Partial matching is performed on the dataset name and description fields; all other fields require an exact match.
tag query any false Filter results to display only items with the specified catalog item tags, in lower case, with no spaces.
accessType query string false Access type used to filter returned results. Valid options are 'owner', 'shared', 'created', and 'any' (the default): 'owner' items are owned by the requester, 'shared' items have been shared with the requester, 'created' items have been created by the requester, and 'any' items matches all.
datasourceType query any false Data source types used for filtering.
category query any false Category type(s) used for filtering. Searches are case sensitive and support '&' and 'OR' operators.
filterFailed query string false Sets whether to exclude from the search results all catalog items that failed during import. If True, invalid catalog items will be excluded; default is False.
ownerUserId query any false Filter results to display only those owned by user(s) identified by the specified UID.
ownerUsername query any false Filter results to display only those owned by user(s) identified by the specified username.
type query string false Filter results by catalog type. The 'dataset' option matches both 'snapshot_dataset' and 'remote_dataset'.
isUxrPreviewable query boolean false Filter results by catalogType = 'snapshot_dataset' and catalogType = 'remote_dataset' and data_origin in ['snowflake', 'bigquery-v1']

Enumerated Values

Parameter Value
useCache [false, False, true, True]
orderBy [originalName, -originalName, catalogName, -catalogName, description, -description, created, -created, relevance, -relevance]
accessType [owner, shared, any, created]
filterFailed [false, False, true, True]
type [dataset, snapshot_dataset, remote_dataset, user_blueprint]

Example responses

200 Response

{
  "cacheHit": true,
  "count": 0,
  "data": [
    {
      "canShareDatasetData": true,
      "canUseDatasetData": true,
      "catalogName": "string",
      "catalogType": "unknown_dataset_type",
      "dataEngineQueryId": "string",
      "dataOrigin": "string",
      "dataSourceId": "string",
      "description": "string",
      "error": "string",
      "id": "string",
      "infoCreationDate": "string",
      "infoCreatorFullName": "string",
      "infoModificationDate": "string",
      "infoModifierFullName": "string",
      "isDataEngineEligible": true,
      "isFirstVersion": true,
      "lastModificationDate": "string",
      "lastModifierFullName": "string",
      "originalName": "string",
      "processingState": 0,
      "projectsUsedInCount": 0,
      "recipeId": "string",
      "relevance": 0,
      "tags": [
        "string"
      ],
      "uri": "string",
      "userBlueprintId": "string"
    }
  ],
  "next": "string",
  "previous": "string",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK Paginated list of catalog items is returned. CatalogListSearchResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/catalogItems/{catalogId}/

Retrieves latest version information, by ID, for catalog items.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/catalogItems/{catalogId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
catalogId path string true Catalog item ID.

Example responses

200 Response

{
  "createdAt": "2019-08-24T14:15:22Z",
  "createdBy": "string",
  "description": "string",
  "id": "string",
  "message": "string",
  "modifiedAt": "2019-08-24T14:15:22Z",
  "modifiedBy": "string",
  "name": "string",
  "status": "COMPLETED",
  "tags": [
    "string"
  ],
  "type": "unknown_dataset_type"
}

Responses

Status Meaning Description Schema
200 OK Catalog item details retrieved successfully. CatalogDetailsRetrieveResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/catalogItems/{catalogId}/

Update the name, description, or tags for the requested catalog item.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/catalogItems/{catalogId}/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "description": "string",
  "name": "string",
  "tags": [
    "string"
  ]
}

Parameters

Name In Type Required Description
catalogId path string true Catalog item ID.
body body UpdateCatalogMetadata false none

Example responses

200 Response

{
  "canShareDatasetData": true,
  "canUseDatasetData": true,
  "catalogName": "string",
  "catalogType": "unknown_dataset_type",
  "dataEngineQueryId": "string",
  "dataSourceId": "string",
  "description": "string",
  "error": "string",
  "id": "string",
  "infoCreationDate": "string",
  "infoCreatorFullName": "string",
  "infoModificationDate": "string",
  "infoModifierFullName": "string",
  "isDataEngineEligible": true,
  "isFirstVersion": true,
  "lastModificationDate": "string",
  "lastModifierFullName": "string",
  "originalName": "string",
  "processingState": 0,
  "projectsUsedInCount": 0,
  "recipeId": "string",
  "relevance": 0,
  "tags": [
    "string"
  ],
  "uri": "string",
  "userBlueprintId": "string"
}

Responses

Status Meaning Description Schema
200 OK Extended details of the updated catalog item. CatalogExtendedDetailsResponse
403 Forbidden User does not have permission to update this catalog item. None
410 Gone Requested catalog item was previously deleted. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/dataEngineQueryGenerators/

Create a data engine query generator.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/dataEngineQueryGenerators/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "datasets": [
    {
      "alias": "string",
      "datasetId": "string",
      "datasetVersionId": "string"
    }
  ],
  "generatorSettings": {
    "datetimePartitionColumn": "string",
    "defaultCategoricalAggregationMethod": "last",
    "defaultNumericAggregationMethod": "mean",
    "defaultTextAggregationMethod": "concat",
    "endToSeriesMaxDatetime": true,
    "multiseriesIdColumns": [
      "string"
    ],
    "startFromSeriesMinDatetime": true,
    "target": "string",
    "timeStep": 0,
    "timeUnit": "DAY"
  },
  "generatorType": "TimeSeries"
}

Parameters

Name In Type Required Description
body body CreateDataEngineQueryGenerator false none

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. None
403 Forbidden User does not have access to this functionality. None
422 Unprocessable Entity Unable to process data engine query generation. None

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/dataEngineQueryGenerators/{dataEngineQueryGeneratorId}/

Retrieve a data engine query generator

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/dataEngineQueryGenerators/{dataEngineQueryGeneratorId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
dataEngineQueryGeneratorId path string true The ID of the data engine query generator.

Example responses

200 Response

{
  "datasets": [
    {
      "alias": "string",
      "datasetId": "string",
      "datasetVersionId": "string"
    }
  ],
  "generatorSettings": {
    "datetimePartitionColumn": "string",
    "defaultCategoricalAggregationMethod": "last",
    "defaultNumericAggregationMethod": "mean",
    "defaultTextAggregationMethod": "concat",
    "endToSeriesMaxDatetime": true,
    "multiseriesIdColumns": [
      "string"
    ],
    "startFromSeriesMinDatetime": true,
    "target": "string",
    "timeStep": 0,
    "timeUnit": "DAY"
  },
  "generatorType": "TimeSeries",
  "id": "string",
  "query": "string"
}

Responses

Status Meaning Description Schema
200 OK none RetrieveDataEngineQueryResponse
403 Forbidden User does not have access to this functionality. None
404 Not Found Specified query generator was not found. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/dataEngineWorkspaceStates/

Create Data Engine workspace state in database.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/dataEngineWorkspaceStates/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "datasets": [
    {
      "alias": "string",
      "datasetId": "string",
      "datasetVersionId": "string"
    }
  ],
  "language": "SQL",
  "query": "string"
}

Parameters

Name In Type Required Description
body body CreateWorkspaceState false none

Example responses

200 Response

{
  "workspaceStateId": "string"
}

Responses

Status Meaning Description Schema
200 OK The Data Engine Workspace state WorkspaceSourceCreatedResponse
410 Gone Specified workspace state was already deleted. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/dataEngineWorkspaceStates/fromDataEngineQueryGenerator/

Create Data Engine workspace state in database from a query generator.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/dataEngineWorkspaceStates/fromDataEngineQueryGenerator/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "datasetId": "string",
  "datasetVersionId": "string",
  "queryGeneratorId": "string"
}

Parameters

Name In Type Required Description
body body CreateWorkspaceStateFromQueryGenerator false none

Example responses

201 Response

{
  "datasets": [
    {
      "alias": "string",
      "datasetId": "string",
      "datasetVersionId": "string"
    }
  ],
  "language": "string",
  "query": "string",
  "queryGeneratorId": "string",
  "workspaceStateId": "string"
}

Responses

Status Meaning Description Schema
201 Created The Data Engine Workspace state WorkspaceStateCreatedFromQueryGeneratorResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/dataEngineWorkspaceStates/{workspaceStateId}/

Read and return previously stored Data Engine workspace state.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/dataEngineWorkspaceStates/{workspaceStateId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
workspaceStateId path string true The ID of the Data Engine workspace state.

Example responses

200 Response

{
  "datasets": [
    {
      "alias": "string",
      "datasetId": "string",
      "datasetVersionId": "string",
      "needsCredentials": true
    }
  ],
  "language": "string",
  "query": "string",
  "queryGeneratorId": "string",
  "runTime": 0
}

Responses

Status Meaning Description Schema
200 OK The Data Engine workspace state WorkspaceStateResponse
410 Gone Specified workspace state was already deleted. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/

List all datasets accessible by the user.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/?limit=100&offset=0 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
category query string false If specified, only dataset versions that have the specified category will be included in the results. Categories identify the intended use of the dataset.
orderBy query string false Sorting order which will be applied to catalog list.
limit query integer true At most this many results are returned.
offset query integer true This many results will be skipped.
filterFailed query string false Whether datasets that failed during import should be excluded from the results. If True invalid datasets will be excluded.
datasetVersionIds query any false If specified will only return datasets that are associated with specified dataset versions. Cannot be used as the same time with experiment_container_ids.

Enumerated Values

Parameter Value
category [TRAINING, PREDICTION]
orderBy [created, -created]
filterFailed [false, False, true, True]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "categories": [
        "BATCH_PREDICTIONS"
      ],
      "columnCount": 0,
      "createdBy": "string",
      "creationDate": "2019-08-24T14:15:22Z",
      "dataPersisted": true,
      "datasetId": "string",
      "datasetSize": 0,
      "isDataEngineEligible": true,
      "isLatestVersion": true,
      "isSnapshot": true,
      "name": "string",
      "processingState": "COMPLETED",
      "rowCount": 0,
      "sampleSize": {
        "type": "rows",
        "value": 0
      },
      "timeSeriesProperties": {
        "isMostlyImputed": null
      },
      "versionId": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of datasets DatasetListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/

Execute the specified bulk action on multiple datasets.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "datasetIds": [
    "string"
  ],
  "payload": {
    "action": "delete"
  }
}

Parameters

Name In Type Required Description
body body BulkDatasetAction false none

Responses

Status Meaning Description Schema
204 No Content Successfully executed None
409 Conflict Cannot delete a dataset that has refresh jobs. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/fromDataEngineWorkspaceState/

Create a dataset from a Data Engine workspace state.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/fromDataEngineWorkspaceState/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "credentials": "string",
  "datasetName": "string",
  "doSnapshot": true,
  "workspaceStateId": "string"
}

Parameters

Name In Type Required Description
body body DatasetCreateFromWorkspaceState false none

Example responses

202 Response

{
  "datasetId": "string",
  "datasetVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetDataEngineResponse
410 Gone Specified query output was already deleted. None

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/fromDataSource/

Create a Dataset Item from a data source.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/fromDataSource/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "dataSourceId": "string",
  "doSnapshot": true,
  "password": "string",
  "persistDataAfterIngestion": true,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "useKerberos": false,
  "user": "string"
}

Parameters

Name In Type Required Description
body body Datasource false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/fromFile/

Create a dataset from a file.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/fromFile/ \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

categories: BATCH_PREDICTIONS
file: string

Parameters

Name In Type Required Description
body body DatasetFromFile false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse
422 Unprocessable Entity The request cannot be processed. The request did not contain file contents. None

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/fromHDFS/

Create a Dataset Item from an HDFS URL.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/fromHDFS/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "doSnapshot": true,
  "namenodeWebhdfsPort": 0,
  "password": "string",
  "persistDataAfterIngestion": true,
  "url": "http://example.com",
  "user": "string"
}

Parameters

Name In Type Required Description
body body Hdfs false none

Responses

Status Meaning Description Schema
200 OK none None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/fromRecipe/

Create a dataset item and version from a recipe.During publishing, an immutable copy of the recipe is created, as well as a copy of the recipe's data source.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/fromRecipe/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "doSnapshot": true,
  "materializationDestination": {
    "catalog": "string",
    "schema": "string",
    "table": "string"
  },
  "name": "string",
  "persistDataAfterIngestion": true,
  "recipeId": "string",
  "useKerberos": false
}

Parameters

Name In Type Required Description
body body CreateFromRecipe false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/fromURL/

Create a Dataset Item from a URL.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/fromURL/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "doSnapshot": true,
  "persistDataAfterIngestion": true,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "url": "string"
}

Parameters

Name In Type Required Description
body body Url false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/datasets/{datasetId}/

Marks the dataset with the given ID as deleted.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/datasets/{datasetId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.

Responses

Status Meaning Description Schema
204 No Content Successfully deleted None
409 Conflict Cannot delete a dataset that has refresh jobs. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/

Retrieves the details of the dataset with given ID.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.

Example responses

200 Response

{
  "categories": [
    "BATCH_PREDICTIONS"
  ],
  "columnCount": 0,
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "dataEngineQueryId": "string",
  "dataPersisted": true,
  "dataSourceId": "string",
  "dataSourceType": "string",
  "datasetId": "string",
  "datasetSize": 0,
  "description": "string",
  "eda1ModificationDate": "2019-08-24T14:15:22Z",
  "eda1ModifierFullName": "string",
  "entityCountByType": {
    "numCalendars": 0,
    "numExternalModelPackages": 0,
    "numFeatureDiscoveryConfigs": 0,
    "numPredictionDatasets": 0,
    "numProjects": 0,
    "numSparkSqlQueries": 0
  },
  "error": "string",
  "featureCount": 0,
  "featureCountByType": [
    {
      "count": 0,
      "featureType": "string"
    }
  ],
  "featureDiscoveryProjectId": "string",
  "isDataEngineEligible": true,
  "isLatestVersion": true,
  "isSnapshot": true,
  "isWranglingEligible": true,
  "lastModificationDate": "2019-08-24T14:15:22Z",
  "lastModifierFullName": "string",
  "name": "string",
  "processingState": "COMPLETED",
  "recipeId": "string",
  "rowCount": 0,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "tags": [
    "string"
  ],
  "timeSeriesProperties": {
    "isMostlyImputed": null
  },
  "uri": "string",
  "versionId": "string"
}

Responses

Status Meaning Description Schema
200 OK The dataset details FullDatasetDetailsResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/{datasetId}/

Modifies the specified dataset.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/{datasetId}/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "name": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body PatchDataset false none

Example responses

200 Response

{
  "categories": [
    "BATCH_PREDICTIONS"
  ],
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "dataPersisted": true,
  "datasetId": "string",
  "isDataEngineEligible": true,
  "isLatestVersion": true,
  "isSnapshot": true,
  "name": "string",
  "processingState": "COMPLETED",
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "timeSeriesProperties": {
    "isMostlyImputed": null
  },
  "versionId": "string"
}

Responses

Status Meaning Description Schema
200 OK Dataset successfully modified BasicDatasetDetailsResponse
422 Unprocessable Entity The categories are not applicable to the dataset. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/accessControl/

List the users and their associated roles for the specified dataset.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/accessControl/?offset=0&limit=100 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
userId query string false Only return the access control information for a user with this user ID.
username query string false Only return the access control information for a user with this username.
offset query integer true This many results will be skipped.
limit query integer true At most this many results are returned.
datasetId path string true The ID of the dataset.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "canShare": true,
      "canUseData": true,
      "role": "OWNER",
      "userFullName": "string",
      "username": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of user permissions DatasetAccessControlListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/{datasetId}/accessControl/

Grant access to the dataset at the specified role level, or remove access to the dataset.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/{datasetId}/accessControl/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "applyGrantToLinkedObjects": false,
  "data": [
    {
      "canShare": true,
      "canUseData": true,
      "role": "CONSUMER",
      "username": "string"
    }
  ]
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body DatasetAccessSet false none

Responses

Status Meaning Description Schema
204 No Content Successfully modified None
409 Conflict Duplicate entry for a user in permission list or the request would leave the dataset without an owner. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/allFeaturesDetails/

Return detailed information on all the features and transforms for this dataset.If the Dataset Item has attribute snapshot = True, all optional fields also appear

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/allFeaturesDetails/?limit=100&offset=0&orderBy=featureType \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true At most this many results are returned. The default may change and a maximum limit may be imposed without notice.
offset query integer true This many results will be skipped.
orderBy query string true How the features should be ordered.
includePlot query string false Include histogram plot data in the response.
searchFor query string false A value to search for in the feature name. The search is case insensitive. If no value is provided, an empty string is used, or the string contains only whitespace, no filtering occurs.
featurelistId query string false ID of a featurelist. If specified, only returns features that are present in the specified featurelist.
datasetId path string true The ID of the dataset.

Enumerated Values

Parameter Value
orderBy [featureType, name, id, unique, missing, stddev, mean, median, min, max, -featureType, -name, -id, -unique, -missing, -stddev, -mean, -median, -min, -max]
includePlot [false, False, true, True]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "datasetId": "string",
      "datasetVersionId": "string",
      "dateFormat": "string",
      "featureType": "Boolean",
      "id": 0,
      "isZeroInflated": true,
      "keySummary": {
        "key": "string",
        "summary": {
          "dataQualities": "ISSUES_FOUND",
          "max": 0,
          "mean": 0,
          "median": 0,
          "min": 0,
          "pctRows": 0,
          "stdDev": 0
        }
      },
      "language": "string",
      "lowInformation": true,
      "max": 0,
      "mean": 0,
      "median": 0,
      "min": 0,
      "naCount": 0,
      "name": "string",
      "plot": [
        {
          "count": 0,
          "label": "string"
        }
      ],
      "stdDev": 0,
      "timeSeriesEligibilityReason": "string",
      "timeSeriesEligibilityReasonAggregation": "string",
      "timeSeriesEligible": true,
      "timeSeriesEligibleAggregation": true,
      "timeStep": 0,
      "timeStepAggregation": 0,
      "timeUnit": "string",
      "timeUnitAggregation": "string",
      "uniqueCount": 0
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of feature info DatasetFeaturesListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/{datasetId}/deleted/

Recover the dataset item with given datasetId from deleted.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/{datasetId}/deleted/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body UpdateDatasetDeleted false none

Responses

Status Meaning Description Schema
200 OK Item was not deleted: nothing to recover. None
204 No Content Successfully recovered None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/featureHistograms/{featureName}/

Get histogram chart data for a specific feature in the specified dataset.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/featureHistograms/{featureName}/?binLimit=60 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
binLimit query integer true Maximum number of bins in the returned plot.
key query string false Only required for the Summarized categorical feature. Name of the top 50 key for which plot to be retrieved.
usePlot2 query string false Use frequent values plot data instead of histogram for supported feature types.
datasetId path string true The ID of the dataset entry to retrieve.
featureName path string true The name of the feature.

Example responses

200 Response

{
  "plot": [
    {
      "count": 0,
      "label": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK The feature histogram DatasetFeatureHistogramResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/featureTransforms/

Retrieves the transforms of the dataset with given ID.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/featureTransforms/?limit=100&offset=0 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true At most this many results are returned. The default may change and a maximum limit may be imposed without notice.
offset query integer true This many results will be skipped.
datasetId path string true The ID of the dataset.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "dateExtraction": "year",
      "name": "string",
      "parentName": "string",
      "replacement": "string",
      "variableType": "text"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of feature transforms DatasetTransformListResponse
410 Gone Dataset deleted. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/featureTransforms/

Create a new feature by changing the type of an existing one.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/featureTransforms/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "dateExtraction": "year",
  "name": "string",
  "parentName": "string",
  "replacement": "string",
  "variableType": "text"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body FeatureTransform false none

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. None
409 Conflict Feature name already exists. None
410 Gone Dataset deleted. None
422 Unprocessable Entity In case of an invalid transformation or when dataset does not have profile data or sample files available. None

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/featureTransforms/{featureName}/

Retrieve the specified feature with descriptive information.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/featureTransforms/{featureName}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The dataset to select feature from.
featureName path string true The name of the feature. Note that DataRobot renames some features, so the feature name may not be the one from your original data. Non-ascii features names should be utf-8-encoded (before URL-quoting).

Example responses

200 Response

{
  "dateExtraction": "year",
  "name": "string",
  "parentName": "string",
  "replacement": "string",
  "variableType": "text"
}

Responses

Status Meaning Description Schema
200 OK The feature transform DatasetTransformResponse
410 Gone Dataset deleted. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/featurelists/

Retrieves the featurelists of the dataset with given ID and the latest dataset version.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/featurelists/?limit=100&offset=0&orderBy=name \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true At most this many results are returned. The default may change and a maximum limit may be imposed without notice.
offset query integer true This many results will be skipped.
orderBy query string true How the feature lists should be ordered.
searchFor query string false A value to search for in the featurelist name. The search is case insensitive. If no value is provided, an empty string is used, or the string contains only whitespace, no filtering occurs.
datasetId path string true The ID of the dataset.

Enumerated Values

Parameter Value
orderBy [name, description, featuresNumber, creationDate, userCreated, -name, -description, -featuresNumber, -creationDate, -userCreated]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "createdBy": "string",
      "creationDate": "2019-08-24T14:15:22Z",
      "datasetId": "string",
      "datasetVersionId": "string",
      "features": [
        "string"
      ],
      "id": "string",
      "name": "string",
      "userCreated": true
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of featurelists DatasetFeaturelistListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/featurelists/

Create featurelist for specified dataset.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/featurelists/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "description": "string",
  "features": [
    "string"
  ],
  "name": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body FeatureListCreate false none

Example responses

201 Response

{
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "datasetId": "string",
  "datasetVersionId": "string",
  "features": [
    "string"
  ],
  "id": "string",
  "name": "string",
  "userCreated": true
}

Responses

Status Meaning Description Schema
201 Created Successfully created DatasetFeaturelistResponse
409 Conflict Feature list with specified name already exists None
422 Unprocessable Entity One or more of the specified features does not exist in the dataset None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/datasets/{datasetId}/featurelists/{featurelistId}/

Deletes the indicated featurelist of the dataset with given ID.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/datasets/{datasetId}/featurelists/{featurelistId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
featurelistId path string true The ID of the featurelist.

Responses

Status Meaning Description Schema
204 No Content Successfully deleted None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/featurelists/{featurelistId}/

Retrieves the specified featurelist of the dataset with given ID and the latest dataset version.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/featurelists/{featurelistId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
featurelistId path string true The ID of the featurelist.

Example responses

200 Response

{
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "datasetId": "string",
  "datasetVersionId": "string",
  "features": [
    "string"
  ],
  "id": "string",
  "name": "string",
  "userCreated": true
}

Responses

Status Meaning Description Schema
200 OK The featurelist DatasetFeaturelistResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/{datasetId}/featurelists/{featurelistId}/

Modifies the indicated featurelist of the dataset with given ID.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/{datasetId}/featurelists/{featurelistId}/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "description": "string",
  "name": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
featurelistId path string true The ID of the featurelist.
body body FeatureListModify false none

Responses

Status Meaning Description Schema
200 OK Successfully modified None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/file/

Retrieve all the originally uploaded data, in CSV form.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/file/ \
  -H "Accept: application/vnd.apache.parquet" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.

Example responses

200 Response

Responses

Status Meaning Description Schema
200 OK The original dataset data string
409 Conflict Ingest info is missing for dataset version. None
422 Unprocessable Entity Dataset cannot be downloaded. Possible reasons include "dataPersisted" being false for the dataset, the dataset not being a snapshot, and this dataset is too big to be downloaded (maximum download size depends on a config of your installation). None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/permissions/

Describe what permissions current user has for given dataset.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/permissions/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.

Example responses

200 Response

{
  "canCreateFeaturelist": true,
  "canDeleteDataset": true,
  "canDownloadDatasetData": true,
  "canGetCatalogItemInfo": true,
  "canGetDatasetInfo": true,
  "canGetDatasetPermissions": true,
  "canGetFeatureInfo": true,
  "canGetFeaturelists": true,
  "canPatchCatalogInfo": true,
  "canPatchDatasetAliases": true,
  "canPatchDatasetInfo": true,
  "canPatchDatasetPermissions": true,
  "canPatchFeaturelists": true,
  "canPostDataset": true,
  "canReloadDataset": true,
  "canShareDataset": true,
  "canSnapshotDataset": true,
  "canUndeleteDataset": true,
  "canUseDatasetData": true,
  "canUseFeaturelists": true,
  "datasetId": "string",
  "uid": "string",
  "username": "string"
}

Responses

Status Meaning Description Schema
200 OK The dataset permissions DatasetDescribePermissionsResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/projects/

Retrieves a dataset's projects by dataset ID.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/projects/?limit=100&offset=0 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true Only this many items are returned.
offset query integer true Skip this many items.
datasetId path string true The ID of the dataset.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "id": "string",
      "url": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of projects DatasetProjectListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/refreshJobs/

Paginated list of scheduled jobs descriptions for a specific dataset with given dataset ID, sorted by time of the last update.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/refreshJobs/?limit=100&offset=0 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true Only this many items are returned.
offset query integer true Skip this many items.
datasetId path string true The ID of the dataset.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "categories": "BATCH_PREDICTIONS",
      "createdBy": "string",
      "credentialId": "string",
      "credentials": "string",
      "datasetId": "string",
      "enabled": true,
      "jobId": "string",
      "name": "string",
      "schedule": {
        "dayOfMonth": [
          "*"
        ],
        "dayOfWeek": [
          "*"
        ],
        "hour": [
          "*"
        ],
        "minute": [
          "*"
        ],
        "month": [
          "*"
        ]
      },
      "scheduleReferenceDate": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "updatedBy": "string",
      "useKerberos": true
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK List of a dataset's scheduled job information retrieved successfully. DatasetRefreshJobsListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/refreshJobs/

Create a dataset refresh job that will automatically create dataset snapshots on a schedule.

Optionally if the limit of enabled jobs per user is reached the following metadata will be added to the default error response payload:

  • datasetsWithJob (array) - The list of datasets IDs that have at least one enabled job.
  • errorType (string) - (New in version v2.21) The type of error that happened, possible values include (but are not limited to): Generic Limit Reached, Max Job Limit Reached for Dataset, and Max Job Limit Reached for User.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/refreshJobs/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "credentialId": null,
  "credentials": "string",
  "enabled": true,
  "name": "string",
  "schedule": {
    "dayOfMonth": [
      "*"
    ],
    "dayOfWeek": [
      "*"
    ],
    "hour": [
      "*"
    ],
    "minute": [
      "*"
    ],
    "month": [
      "*"
    ]
  },
  "scheduleReferenceDate": "2019-08-24T14:15:22Z",
  "useKerberos": false
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body DatasetRefreshJobCreate false none

Example responses

201 Response

{
  "categories": "BATCH_PREDICTIONS",
  "createdBy": "string",
  "credentialId": "string",
  "credentials": "string",
  "datasetId": "string",
  "enabled": true,
  "jobId": "string",
  "name": "string",
  "schedule": {
    "dayOfMonth": [
      "*"
    ],
    "dayOfWeek": [
      "*"
    ],
    "hour": [
      "*"
    ],
    "minute": [
      "*"
    ],
    "month": [
      "*"
    ]
  },
  "scheduleReferenceDate": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "updatedBy": "string",
  "useKerberos": true
}

Responses

Status Meaning Description Schema
201 Created Dataset refresh job created. DatasetRefreshJobResponse
409 Conflict The maximum number of enabled jobs is reached. None
422 Unprocessable Entity Refresh job could not be created. Possible reasons include, the job does not belong to the given dataset, credential ID required when Kerberos authentication enabled, or the schedule is not valid or cannot be understood. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/datasets/{datasetId}/refreshJobs/{jobId}/

Deletes an existing dataset refresh job.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/datasets/{datasetId}/refreshJobs/{jobId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The dataset associated with the scheduled refresh job.
jobId path string true ID of the user scheduled dataset refresh job.

Responses

Status Meaning Description Schema
204 No Content Scheduled Job deleted. None
422 Unprocessable Entity Invalid job ID or dataset ID provided. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/refreshJobs/{jobId}/

Gets configuration of a user scheduled dataset refresh job by job ID.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/refreshJobs/{jobId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The dataset associated with the scheduled refresh job.
jobId path string true ID of the user scheduled dataset refresh job.

Example responses

200 Response

{
  "categories": "BATCH_PREDICTIONS",
  "createdBy": "string",
  "credentialId": "string",
  "credentials": "string",
  "datasetId": "string",
  "enabled": true,
  "jobId": "string",
  "name": "string",
  "schedule": {
    "dayOfMonth": [
      "*"
    ],
    "dayOfWeek": [
      "*"
    ],
    "hour": [
      "*"
    ],
    "minute": [
      "*"
    ],
    "month": [
      "*"
    ]
  },
  "scheduleReferenceDate": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "updatedBy": "string",
  "useKerberos": true
}

Responses

Status Meaning Description Schema
200 OK Job information retrieved successfully. DatasetRefreshJobResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/{datasetId}/refreshJobs/{jobId}/

Update a dataset refresh job.

Optionally if the limit of enabled jobs per user is reached the following metadata will be added to the default error response payload:

  • datasetsWithJob (array) - The list of datasets IDs that have at least one enabled job.
  • errorType (string) - (New in version v2.21) The type of error that happened, possible values include (but are not limited to): Generic Limit Reached, Max Job Limit Reached for Dataset, and Max Job Limit Reached for User.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/{datasetId}/refreshJobs/{jobId}/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "credentialId": "string",
  "credentials": "string",
  "enabled": true,
  "name": "string",
  "schedule": {
    "dayOfMonth": [
      "*"
    ],
    "dayOfWeek": [
      "*"
    ],
    "hour": [
      "*"
    ],
    "minute": [
      "*"
    ],
    "month": [
      "*"
    ]
  },
  "scheduleReferenceDate": "2019-08-24T14:15:22Z",
  "useKerberos": true
}

Parameters

Name In Type Required Description
datasetId path string true The dataset associated with the scheduled refresh job.
jobId path string true ID of the user scheduled dataset refresh job.
body body DatasetRefreshJobUpdate false none

Example responses

200 Response

{
  "categories": "BATCH_PREDICTIONS",
  "createdBy": "string",
  "credentialId": "string",
  "credentials": "string",
  "datasetId": "string",
  "enabled": true,
  "jobId": "string",
  "name": "string",
  "schedule": {
    "dayOfMonth": [
      "*"
    ],
    "dayOfWeek": [
      "*"
    ],
    "hour": [
      "*"
    ],
    "minute": [
      "*"
    ],
    "month": [
      "*"
    ]
  },
  "scheduleReferenceDate": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "updatedBy": "string",
  "useKerberos": true
}

Responses

Status Meaning Description Schema
200 OK Scheduled Job configuration updated. DatasetRefreshJobResponse
409 Conflict The maximum number of enabled jobs is reached. None
422 Unprocessable Entity Refresh job could not be updated. Possible reasons include, the job does not belong to the given dataset, credential ID required when Kerberos authentication enabled, or the schedule is not valid or cannot be understood. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/refreshJobs/{jobId}/executionResults/

Paginated list of execution results for refresh job with the given ID and dataset with the given ID, sorted from newest to oldest.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/refreshJobs/{jobId}/executionResults/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer false Maximum number of results returned. The default may change and a maximum limit may be imposed without notice.
offset query integer false Number of results that will be skipped.
datasetId path string true The dataset associated with the scheduled refresh job.
jobId path string true ID of the user scheduled dataset refresh job.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "completedAt": "2019-08-24T14:15:22Z",
      "datasetId": "string",
      "datasetVersionId": "string",
      "executionId": "string",
      "jobId": "string",
      "message": "string",
      "startedAt": "2019-08-24T14:15:22Z",
      "status": "INITIALIZING"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK Paginated list of dataset refresh job results, sorted from latest to oldest. DatasetRefreshJobRetrieveExecutionResultsResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/relationships/

Retrieve a list of the dataset relationships for a specific dataset.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/relationships/?limit=100&offset=0 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true At most this many results are returned.
offset query integer true This many results will be skipped.
linkedDatasetId query string false Providing linkedDatasetId will filter such that only relationships between datasetId (from the path) and linkedDatasetId will be returned.
datasetId path string true The ID of the dataset.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "createdBy": "string",
      "creationDate": "2019-08-24T14:15:22Z",
      "id": "string",
      "linkedDatasetId": "string",
      "linkedFeatures": [
        "string"
      ],
      "modificationDate": "2019-08-24T14:15:22Z",
      "modifiedBy": "string",
      "sourceDatasetId": "string",
      "sourceFeatures": [
        "string"
      ]
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of dataset relationships DatasetRelationshipListResponse
410 Gone Dataset deleted None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/relationships/

Create a dataset relationship.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/relationships/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "linkedDatasetId": "string",
  "linkedFeatures": [
    "string"
  ],
  "sourceFeatures": [
    "string"
  ]
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body DatasetRelationshipCreate false none

Example responses

201 Response

{
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "id": "string",
  "linkedDatasetId": "string",
  "linkedFeatures": [
    "string"
  ],
  "modificationDate": "2019-08-24T14:15:22Z",
  "modifiedBy": "string",
  "sourceDatasetId": "string",
  "sourceFeatures": [
    "string"
  ]
}

Responses

Status Meaning Description Schema
201 Created Successfully created DatasetRelationshipResponse
409 Conflict Relationship already exists. None
410 Gone Dataset deleted. None
422 Unprocessable Entity Missing or unrecognized fields. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/datasets/{datasetId}/relationships/{datasetRelationshipId}/

Delete a dataset relationship.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/datasets/{datasetId}/relationships/{datasetRelationshipId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
datasetRelationshipId path string true The ID of the dataset relationship to delete.

Responses

Status Meaning Description Schema
204 No Content Successfully deleted None
410 Gone Dataset deleted. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/{datasetId}/relationships/{datasetRelationshipId}/

Update a dataset relationship.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/{datasetId}/relationships/{datasetRelationshipId}/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "linkedDatasetId": "string",
  "linkedFeatures": [
    "string"
  ],
  "sourceFeatures": [
    "string"
  ]
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
datasetRelationshipId path string true The ID of the dataset relationship to delete.
body body DatasetRelationshipUpdate false none

Example responses

200 Response

{
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "id": "string",
  "linkedDatasetId": "string",
  "linkedFeatures": [
    "string"
  ],
  "modificationDate": "2019-08-24T14:15:22Z",
  "modifiedBy": "string",
  "sourceDatasetId": "string",
  "sourceFeatures": [
    "string"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successfully updated DatasetRelationshipResponse
409 Conflict Relationship already exists None
410 Gone Dataset deleted None
422 Unprocessable Entity Bad payload: missing or unrecognized fields None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/sharedRoles/

Get a list of users, groups and organizations who have access to this dataset and their roles.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/sharedRoles/?offset=0&limit=100 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
id query string false Only return the access control information for a organization, group or user with this ID.
name query string false Only return the access control information for a organization, group or user with this name.
shareRecipientType query string false It describes the recipient type.
offset query integer true This many results will be skipped.
limit query integer true At most this many results are returned.
datasetId path string true The ID of the dataset.

Enumerated Values

Parameter Value
shareRecipientType [user, group, organization]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "canShare": true,
      "canUseData": true,
      "id": "string",
      "name": "string",
      "role": "CONSUMER",
      "shareRecipientType": "user",
      "userFullName": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of user permissions SharedRolesListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/{datasetId}/sharedRoles/

Grant access, remove access or update roles for organizations, groups or users on this dataset. Up to 100 roles may be set per array in a single request.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/{datasetId}/sharedRoles/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "applyGrantToLinkedObjects": false,
  "operation": "updateRoles",
  "roles": [
    {
      "canShare": false,
      "canUseData": true,
      "name": "string",
      "role": "CONSUMER",
      "shareRecipientType": "user"
    }
  ]
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body DatasetSharedRoles false none

Responses

Status Meaning Description Schema
204 No Content Successfully modified None
409 Conflict Duplicate entry for the org/group/user in permission listor the request would leave the dataset without an owner. None
422 Unprocessable Entity Request is unprocessable. For example, name is stated for not user recipient. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/versions/

List all versions associated with given datasetId and which match the specified query parameters.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/?limit=100&offset=0 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
category query string false If specified, only dataset versions that have the specified category will be included in the results. Categories identify the intended use of the dataset.
orderBy query string false Sorting order which will be applied to catalog list.
limit query integer true At most this many results are returned.
offset query integer true This many results will be skipped.
filterFailed query string false Whether datasets that failed during import should be excluded from the results. If True invalid datasets will be excluded.
datasetId path string true The ID of the dataset.

Enumerated Values

Parameter Value
category [TRAINING, PREDICTION]
orderBy [created, -created]
filterFailed [false, False, true, True]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "categories": [
        "BATCH_PREDICTIONS"
      ],
      "columnCount": 0,
      "createdBy": "string",
      "creationDate": "2019-08-24T14:15:22Z",
      "dataPersisted": true,
      "datasetId": "string",
      "datasetSize": 0,
      "isDataEngineEligible": true,
      "isLatestVersion": true,
      "isSnapshot": true,
      "name": "string",
      "processingState": "COMPLETED",
      "rowCount": 0,
      "sampleSize": {
        "type": "rows",
        "value": 0
      },
      "timeSeriesProperties": {
        "isMostlyImputed": null
      },
      "versionId": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of dataset versions DatasetListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/versions/fromDataEngineWorkspaceState/

Create a new dataset version for a specified dataset from a Data Engine workspace state. The new dataset version should have the same schema as the specified dataset.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/fromDataEngineWorkspaceState/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "credentials": "string",
  "doSnapshot": true,
  "workspaceStateId": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body DatasetCreateVersionFromWorkspaceState false none

Example responses

202 Response

{
  "datasetId": "string",
  "datasetVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetDataEngineResponse
410 Gone Specified workspace was already deleted. None
422 Unprocessable Entity Type of new dataset version is incompatible with specified dataset. None

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/versions/fromDataSource/

Create a new version for the specified dataset from specified Data Source. The dataset must have been created from a compatible data source originally.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/fromDataSource/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "dataSourceId": "string",
  "doSnapshot": true,
  "password": "string",
  "persistDataAfterIngestion": true,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "useKerberos": false,
  "user": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body Datasource false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/versions/fromFile/

Create a new version for the specified dataset from a file.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/fromFile/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "file": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body DatasetFromFile false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/versions/fromHDFS/

Create a new version for the specified dataset from a HDFS URL. The dataset must have been created from the same HDFS URL originally.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/fromHDFS/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "doSnapshot": true,
  "namenodeWebhdfsPort": 0,
  "password": "string",
  "persistDataAfterIngestion": true,
  "url": "http://example.com",
  "user": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body Hdfs false none

Responses

Status Meaning Description Schema
200 OK none None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/versions/fromLatestVersion/

Create a new version of the specified dataset from the latest dataset version. This will reuse the same source of the data that was previously used. Not supported for datasets that were previously loaded from an uploaded file. If the dataset is currently a remote dataset, it will be converted to a snapshot dataset. NOTE: if the current version uses a Data Source, the user and password must be specified so the data can be accessed.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/fromLatestVersion/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "credentials": "string",
  "password": "string",
  "useKerberos": false,
  "useLatestSuccess": false,
  "user": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body FromLatest false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse
409 Conflict The latest version of the dataset is in an errored state. None

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/versions/fromURL/

Create a new version for the specified dataset from specified URL. The dataset must have been created from the same URL originally.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/fromURL/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "doSnapshot": true,
  "persistDataAfterIngestion": true,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "url": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset.
body body Url false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/

Marks the dataset version with the given ID as deleted.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset entry.
datasetVersionId path string true The ID of the dataset version.

Responses

Status Meaning Description Schema
204 No Content Successfully deleted None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/

Retrieves the details of the dataset with given ID and version ID.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset entry.
datasetVersionId path string true The ID of the dataset version.

Example responses

200 Response

{
  "categories": [
    "BATCH_PREDICTIONS"
  ],
  "columnCount": 0,
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "dataEngineQueryId": "string",
  "dataPersisted": true,
  "dataSourceId": "string",
  "dataSourceType": "string",
  "datasetId": "string",
  "datasetSize": 0,
  "description": "string",
  "eda1ModificationDate": "2019-08-24T14:15:22Z",
  "eda1ModifierFullName": "string",
  "entityCountByType": {
    "numCalendars": 0,
    "numExternalModelPackages": 0,
    "numFeatureDiscoveryConfigs": 0,
    "numPredictionDatasets": 0,
    "numProjects": 0,
    "numSparkSqlQueries": 0
  },
  "error": "string",
  "featureCount": 0,
  "featureCountByType": [
    {
      "count": 0,
      "featureType": "string"
    }
  ],
  "featureDiscoveryProjectId": "string",
  "isDataEngineEligible": true,
  "isLatestVersion": true,
  "isSnapshot": true,
  "isWranglingEligible": true,
  "lastModificationDate": "2019-08-24T14:15:22Z",
  "lastModifierFullName": "string",
  "name": "string",
  "processingState": "COMPLETED",
  "recipeId": "string",
  "rowCount": 0,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "tags": [
    "string"
  ],
  "timeSeriesProperties": {
    "isMostlyImputed": null
  },
  "uri": "string",
  "versionId": "string"
}

Responses

Status Meaning Description Schema
200 OK The dataset details FullDatasetDetailsResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/allFeaturesDetails/

Return detailed information on all the features and transforms for this dataset.If the Dataset Item has attribute snapshot = True, all optional fields also appear

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/allFeaturesDetails/?limit=100&offset=0&orderBy=featureType \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true At most this many results are returned. The default may change and a maximum limit may be imposed without notice.
offset query integer true This many results will be skipped.
orderBy query string true How the features should be ordered.
includePlot query string false Include histogram plot data in the response.
searchFor query string false A value to search for in the feature name. The search is case insensitive. If no value is provided, an empty string is used, or the string contains only whitespace, no filtering occurs.
featurelistId query string false ID of a featurelist. If specified, only returns features that are present in the specified featurelist.
datasetId path string true The ID of the dataset entry.
datasetVersionId path string true The ID of the dataset version.

Enumerated Values

Parameter Value
orderBy [featureType, name, id, unique, missing, stddev, mean, median, min, max, -featureType, -name, -id, -unique, -missing, -stddev, -mean, -median, -min, -max]
includePlot [false, False, true, True]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "datasetId": "string",
      "datasetVersionId": "string",
      "dateFormat": "string",
      "featureType": "Boolean",
      "id": 0,
      "isZeroInflated": true,
      "keySummary": {
        "key": "string",
        "summary": {
          "dataQualities": "ISSUES_FOUND",
          "max": 0,
          "mean": 0,
          "median": 0,
          "min": 0,
          "pctRows": 0,
          "stdDev": 0
        }
      },
      "language": "string",
      "lowInformation": true,
      "max": 0,
      "mean": 0,
      "median": 0,
      "min": 0,
      "naCount": 0,
      "name": "string",
      "plot": [
        {
          "count": 0,
          "label": "string"
        }
      ],
      "stdDev": 0,
      "timeSeriesEligibilityReason": "string",
      "timeSeriesEligibilityReasonAggregation": "string",
      "timeSeriesEligible": true,
      "timeSeriesEligibleAggregation": true,
      "timeStep": 0,
      "timeStepAggregation": 0,
      "timeUnit": "string",
      "timeUnitAggregation": "string",
      "uniqueCount": 0
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of feature info DatasetFeaturesListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/deleted/

Recover the dataset version item with given datasetId and datasetVersionId from deleted.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/deleted/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset entry.
datasetVersionId path string true The ID of the dataset version.
body body UpdateDatasetDeleted false none

Responses

Status Meaning Description Schema
200 OK The item was not deleted: nothing to recover. None
204 No Content Successfully recovered None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/featureHistograms/{featureName}/

Get histogram chart data for a specific feature in the specified dataset.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/featureHistograms/{featureName}/?binLimit=60 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
binLimit query integer true Maximum number of bins in the returned plot.
key query string false Only required for the Summarized categorical feature. Name of the top 50 key for which plot to be retrieved.
usePlot2 query string false Use frequent values plot data instead of histogram for supported feature types.
datasetId path string true The ID of the dataset entry to retrieve.
datasetVersionId path string true The ID of the dataset version to retrieve.
featureName path string true The name of the feature.

Example responses

200 Response

{
  "plot": [
    {
      "count": 0,
      "label": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK The feature histogram DatasetFeatureHistogramResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/featurelists/

Retrieves the featurelists of the dataset with given ID and the latest dataset version.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/featurelists/?limit=100&offset=0&orderBy=name \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true At most this many results are returned. The default may change and a maximum limit may be imposed without notice.
offset query integer true This many results will be skipped.
orderBy query string true How the feature lists should be ordered.
searchFor query string false A value to search for in the featurelist name. The search is case insensitive. If no value is provided, an empty string is used, or the string contains only whitespace, no filtering occurs.
datasetId path string true The ID of the dataset entry.
datasetVersionId path string true The ID of the dataset version.

Enumerated Values

Parameter Value
orderBy [name, description, featuresNumber, creationDate, userCreated, -name, -description, -featuresNumber, -creationDate, -userCreated]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "createdBy": "string",
      "creationDate": "2019-08-24T14:15:22Z",
      "datasetId": "string",
      "datasetVersionId": "string",
      "features": [
        "string"
      ],
      "id": "string",
      "name": "string",
      "userCreated": true
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of featurelists DatasetFeaturelistListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/featurelists/{featurelistId}/

Retrieves the specified featurelist of the dataset with given ID and the latest dataset version.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/featurelists/{featurelistId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset to retrieve featurelist for.
datasetVersionId path string true The ID of the dataset version to retrieve featurelists for.
featurelistId path string true The ID of the featurelist.

Example responses

200 Response

{
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "datasetId": "string",
  "datasetVersionId": "string",
  "features": [
    "string"
  ],
  "id": "string",
  "name": "string",
  "userCreated": true
}

Responses

Status Meaning Description Schema
200 OK The featurelist DatasetFeaturelistResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/file/

Retrieve all the originally uploaded data, in CSV form.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/file/ \
  -H "Accept: application/vnd.apache.parquet" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset entry.
datasetVersionId path string true The ID of the dataset version.

Example responses

200 Response

Responses

Status Meaning Description Schema
200 OK The original dataset data string
409 Conflict Ingest info is missing for dataset version. None
422 Unprocessable Entity Dataset version cannot be downloaded. Possible reasons include dataPersisted being false for the dataset, the dataset not being a snapshot, and this dataset version is too big to be downloaded (maximum download size depends on a config of your installation). None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/fromVersion/

Create a new version of the specified dataset from the specified dataset version. This will reuse the same source of the data that was previously used. Not supported for datasets that were previously loaded from an uploaded file. If the dataset is currently a remote dataset, it will be converted to a snapshot dataset. NOTE: If the specified version uses a Data Source, the user and password must be specified so the data can be accessed.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/fromVersion/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "credentials": "string",
  "password": "string",
  "useKerberos": false,
  "user": "string"
}

Parameters

Name In Type Required Description
datasetId path string true The ID of the dataset entry.
datasetVersionId path string true The ID of the dataset version.
body body FromSpecific false none

Example responses

202 Response

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Responses

Status Meaning Description Schema
202 Accepted Creation has successfully started. See the Location header. CreatedDatasetResponse
409 Conflict The dataset item's specified version is in an errored state. None

Response Headers

Status Header Type Format Description
202 Location string A url that can be polled to check the status.

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/datasets/{datasetId}/versions/{datasetVersionId}/projects/

Retrieves a dataset's projects for the specified catalog dataset and dataset version id.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/datasets/{datasetId}/versions/{datasetVersionId}/projects/?limit=100&offset=0 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
limit query integer true Only this many items are returned.
offset query integer true Skip this many items.
datasetId path string true The ID of the dataset entry.
datasetVersionId path string true The ID of the dataset version.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "id": "string",
      "url": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of projects GetDatasetVersionProjectsResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/userBlueprints/

Delete user blueprints, specified by userBlueprintIds.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/userBlueprints/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "userBlueprintIds": "string"
}

Parameters

Name In Type Required Description
body body UserBlueprintsBulkDelete false none

Example responses

200 Response

{
  "failedToDelete": [
    "string"
  ],
  "successfullyDeleted": [
    "string"
  ]
}

Responses

Status Meaning Description Schema
200 OK A list of user blueprints successfully and unsuccessfully deleted. UserBlueprintsBulkDeleteResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/userBlueprints/

Fetch a list of the user blueprints the current user has access to

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/userBlueprints/?offset=0&limit=100 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
offset query integer true The number of results to skip (for pagination).
limit query integer true The max number of results to return.
projectId query string false The id of the project, used to filter for original project_id.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "blender": false,
      "blueprintId": "string",
      "customTaskVersionMetadata": [
        [
          "string",
          "string"
        ]
      ],
      "decompressedFormat": false,
      "diagram": "string",
      "features": [
        "string"
      ],
      "featuresText": "string",
      "hexColumnNameLookup": [
        {
          "colname": "string",
          "hex": "string",
          "projectId": "string"
        }
      ],
      "hiddenFromCatalog": true,
      "icons": [
        0
      ],
      "insights": "string",
      "isTimeSeries": false,
      "linkedToProjectId": true,
      "modelType": "string",
      "projectId": "string",
      "referenceModel": false,
      "shapSupport": false,
      "supportedTargetTypes": [
        "binary"
      ],
      "supportsGpu": false,
      "supportsNewSeries": true,
      "userBlueprintId": "string",
      "userId": "string"
    }
  ],
  "next": "string",
  "previous": "string",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK Fetched the list of the accessible user blueprints successfully UserBlueprintsListResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/userBlueprints/

Create a user blueprint

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/userBlueprints/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "decompressedBlueprint": false,
  "description": "string",
  "getDynamicLabels": false,
  "isInplaceEditor": false,
  "modelType": "string",
  "projectId": "string",
  "saveToCatalog": true
}

Parameters

Name In Type Required Description
body body UserBlueprintCreate false none

Example responses

200 Response

{
  "blender": false,
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "blueprintId": "string",
  "bpData": {
    "children": [
      {}
    ],
    "id": "string",
    "inputs": [
      "string"
    ],
    "output": "string",
    "taskMap": {},
    "taskParameters": "string",
    "tasks": [
      "string"
    ],
    "type": "string"
  },
  "customTaskVersionMetadata": [
    [
      "string",
      "string"
    ]
  ],
  "decompressedFormat": false,
  "diagram": "string",
  "features": [
    "string"
  ],
  "featuresText": "string",
  "hexColumnNameLookup": [
    {
      "colname": "string",
      "hex": "string",
      "projectId": "string"
    }
  ],
  "hiddenFromCatalog": true,
  "icons": [
    0
  ],
  "insights": "string",
  "isTimeSeries": false,
  "linkedToProjectId": true,
  "modelType": "string",
  "projectId": "string",
  "referenceModel": false,
  "shapSupport": false,
  "supportedTargetTypes": [
    "binary"
  ],
  "supportsGpu": false,
  "supportsNewSeries": true,
  "userBlueprintId": "string",
  "userId": "string",
  "vertexContext": [
    {
      "information": {
        "inputs": [
          "string"
        ],
        "outputs": [
          "string"
        ]
      },
      "messages": {
        "errors": [
          "string"
        ],
        "warnings": [
          "string"
        ]
      },
      "taskId": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Created the user blueprint successfully UserBlueprintsDetailedItem
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Project not found. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/userBlueprints/fromBlueprintId/

Clone a blueprint from a project.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/userBlueprints/fromBlueprintId/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "blueprintId": "string",
  "decompressedBlueprint": false,
  "description": "string",
  "getDynamicLabels": false,
  "isInplaceEditor": false,
  "modelType": "string",
  "projectId": "string",
  "saveToCatalog": true
}

Parameters

Name In Type Required Description
body body UserBlueprintCreateFromBlueprintId false none

Example responses

200 Response

{
  "blender": false,
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "blueprintId": "string",
  "bpData": {
    "children": [
      {}
    ],
    "id": "string",
    "inputs": [
      "string"
    ],
    "output": "string",
    "taskMap": {},
    "taskParameters": "string",
    "tasks": [
      "string"
    ],
    "type": "string"
  },
  "customTaskVersionMetadata": [
    [
      "string",
      "string"
    ]
  ],
  "decompressedFormat": false,
  "diagram": "string",
  "features": [
    "string"
  ],
  "featuresText": "string",
  "hexColumnNameLookup": [
    {
      "colname": "string",
      "hex": "string",
      "projectId": "string"
    }
  ],
  "hiddenFromCatalog": true,
  "icons": [
    0
  ],
  "insights": "string",
  "isTimeSeries": false,
  "linkedToProjectId": true,
  "modelType": "string",
  "projectId": "string",
  "referenceModel": false,
  "shapSupport": false,
  "supportedTargetTypes": [
    "binary"
  ],
  "supportsGpu": false,
  "supportsNewSeries": true,
  "userBlueprintId": "string",
  "userId": "string",
  "vertexContext": [
    {
      "information": {
        "inputs": [
          "string"
        ],
        "outputs": [
          "string"
        ]
      },
      "messages": {
        "errors": [
          "string"
        ],
        "warnings": [
          "string"
        ]
      },
      "taskId": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Created the user blueprint successfully UserBlueprintsDetailedItem
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Project or blueprint not found. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/userBlueprints/fromCustomTaskVersionId/

Create a user blueprint from a single custom task.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/userBlueprints/fromCustomTaskVersionId/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "customTaskVersionId": "string",
  "decompressedBlueprint": false,
  "description": "string",
  "saveToCatalog": true
}

Parameters

Name In Type Required Description
body body UserBlueprintCreateFromCustomTaskVersionIdPayload false none

Example responses

200 Response

{
  "blender": false,
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "blueprintId": "string",
  "bpData": {
    "children": [
      {}
    ],
    "id": "string",
    "inputs": [
      "string"
    ],
    "output": "string",
    "taskMap": {},
    "taskParameters": "string",
    "tasks": [
      "string"
    ],
    "type": "string"
  },
  "customTaskVersionMetadata": [
    [
      "string",
      "string"
    ]
  ],
  "decompressedFormat": false,
  "diagram": "string",
  "features": [
    "string"
  ],
  "featuresText": "string",
  "hexColumnNameLookup": [
    {
      "colname": "string",
      "hex": "string",
      "projectId": "string"
    }
  ],
  "hiddenFromCatalog": true,
  "icons": [
    0
  ],
  "insights": "string",
  "isTimeSeries": false,
  "linkedToProjectId": true,
  "modelType": "string",
  "projectId": "string",
  "referenceModel": false,
  "shapSupport": false,
  "supportedTargetTypes": [
    "binary"
  ],
  "supportsGpu": false,
  "supportsNewSeries": true,
  "userBlueprintId": "string",
  "userId": "string",
  "vertexContext": [
    {
      "information": {
        "inputs": [
          "string"
        ],
        "outputs": [
          "string"
        ]
      },
      "messages": {
        "errors": [
          "string"
        ],
        "warnings": [
          "string"
        ]
      },
      "taskId": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Created the user blueprint successfully UserBlueprintsDetailedItem
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Custom task version or custom task not found. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/userBlueprints/fromUserBlueprintId/

Clone a user blueprint.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/userBlueprints/fromUserBlueprintId/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "decompressedBlueprint": false,
  "description": "string",
  "getDynamicLabels": false,
  "isInplaceEditor": false,
  "modelType": "string",
  "projectId": "string",
  "saveToCatalog": true,
  "userBlueprintId": "string"
}

Parameters

Name In Type Required Description
body body UserBlueprintCreateFromUserBlueprintId false none

Example responses

200 Response

{
  "blender": false,
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "blueprintId": "string",
  "bpData": {
    "children": [
      {}
    ],
    "id": "string",
    "inputs": [
      "string"
    ],
    "output": "string",
    "taskMap": {},
    "taskParameters": "string",
    "tasks": [
      "string"
    ],
    "type": "string"
  },
  "customTaskVersionMetadata": [
    [
      "string",
      "string"
    ]
  ],
  "decompressedFormat": false,
  "diagram": "string",
  "features": [
    "string"
  ],
  "featuresText": "string",
  "hexColumnNameLookup": [
    {
      "colname": "string",
      "hex": "string",
      "projectId": "string"
    }
  ],
  "hiddenFromCatalog": true,
  "icons": [
    0
  ],
  "insights": "string",
  "isTimeSeries": false,
  "linkedToProjectId": true,
  "modelType": "string",
  "projectId": "string",
  "referenceModel": false,
  "shapSupport": false,
  "supportedTargetTypes": [
    "binary"
  ],
  "supportsGpu": false,
  "supportsNewSeries": true,
  "userBlueprintId": "string",
  "userId": "string",
  "vertexContext": [
    {
      "information": {
        "inputs": [
          "string"
        ],
        "outputs": [
          "string"
        ]
      },
      "messages": {
        "errors": [
          "string"
        ],
        "warnings": [
          "string"
        ]
      },
      "taskId": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Created the user blueprint successfully UserBlueprintsDetailedItem
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found User blueprint or project not found. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/userBlueprints/{userBlueprintId}/

Delete a user blueprint, specified by the userBlueprintId.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/userBlueprints/{userBlueprintId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
userBlueprintId path string true Used to identify a specific user-owned blueprint.

Responses

Status Meaning Description Schema
204 No Content Successfully deleted the specified blueprint, if it existed. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/userBlueprints/{userBlueprintId}/

Retrieve a user blueprint

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/userBlueprints/{userBlueprintId}/?editMode=false&decompressedBlueprint=false&isInplaceEditor=false \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
editMode query boolean true Whether to retrieve the extra blueprint metadata for editing.
decompressedBlueprint query boolean true Whether to retrieve the blueprint in the decompressed format.
projectId query string false String representation of ObjectId for the currently active project. The user blueprint is retrieved when this project is active.
isInplaceEditor query boolean true Whether the request is sent from the in place user BP editor.
getDynamicLabels query boolean false Whether to add dynamic labels to a decompressed blueprint.
userBlueprintId path string true Used to identify a specific user-owned blueprint.

Example responses

200 Response

{
  "blender": false,
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "blueprintId": "string",
  "bpData": {
    "children": [
      {}
    ],
    "id": "string",
    "inputs": [
      "string"
    ],
    "output": "string",
    "taskMap": {},
    "taskParameters": "string",
    "tasks": [
      "string"
    ],
    "type": "string"
  },
  "customTaskVersionMetadata": [
    [
      "string",
      "string"
    ]
  ],
  "decompressedFormat": false,
  "diagram": "string",
  "features": [
    "string"
  ],
  "featuresText": "string",
  "hexColumnNameLookup": [
    {
      "colname": "string",
      "hex": "string",
      "projectId": "string"
    }
  ],
  "hiddenFromCatalog": true,
  "icons": [
    0
  ],
  "insights": "string",
  "isTimeSeries": false,
  "linkedToProjectId": true,
  "modelType": "string",
  "projectId": "string",
  "referenceModel": false,
  "shapSupport": false,
  "supportedTargetTypes": [
    "binary"
  ],
  "supportsGpu": false,
  "supportsNewSeries": true,
  "userBlueprintId": "string",
  "userId": "string",
  "vertexContext": [
    {
      "information": {
        "inputs": [
          "string"
        ],
        "outputs": [
          "string"
        ]
      },
      "messages": {
        "errors": [
          "string"
        ],
        "warnings": [
          "string"
        ]
      },
      "taskId": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Retrieved the user blueprint successfully UserBlueprintsRetrieveResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Referenced project or user blueprint not found. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/userBlueprints/{userBlueprintId}/

Update a user blueprint

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/userBlueprints/{userBlueprintId}/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "decompressedBlueprint": false,
  "description": "string",
  "getDynamicLabels": false,
  "isInplaceEditor": false,
  "modelType": "string",
  "projectId": "string",
  "saveToCatalog": true
}

Parameters

Name In Type Required Description
userBlueprintId path string true Used to identify a specific user-owned blueprint.
body body UserBlueprintUpdate false none

Example responses

200 Response

{
  "blender": false,
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "blueprintId": "string",
  "bpData": {
    "children": [
      {}
    ],
    "id": "string",
    "inputs": [
      "string"
    ],
    "output": "string",
    "taskMap": {},
    "taskParameters": "string",
    "tasks": [
      "string"
    ],
    "type": "string"
  },
  "customTaskVersionMetadata": [
    [
      "string",
      "string"
    ]
  ],
  "decompressedFormat": false,
  "diagram": "string",
  "features": [
    "string"
  ],
  "featuresText": "string",
  "hexColumnNameLookup": [
    {
      "colname": "string",
      "hex": "string",
      "projectId": "string"
    }
  ],
  "hiddenFromCatalog": true,
  "icons": [
    0
  ],
  "insights": "string",
  "isTimeSeries": false,
  "linkedToProjectId": true,
  "modelType": "string",
  "projectId": "string",
  "referenceModel": false,
  "shapSupport": false,
  "supportedTargetTypes": [
    "binary"
  ],
  "supportsGpu": false,
  "supportsNewSeries": true,
  "userBlueprintId": "string",
  "userId": "string",
  "vertexContext": [
    {
      "information": {
        "inputs": [
          "string"
        ],
        "outputs": [
          "string"
        ]
      },
      "messages": {
        "errors": [
          "string"
        ],
        "warnings": [
          "string"
        ]
      },
      "taskId": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Updated the user blueprint successfully UserBlueprintsDetailedItem
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found User blueprint not found. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/userBlueprints/{userBlueprintId}/sharedRoles/

Get a list of users, groups and organizations that have an access to this user blueprint

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/userBlueprints/{userBlueprintId}/sharedRoles/?offset=0&limit=10 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
id query string false Only return roles for a user, group or organization with this identifier.
offset query integer true This many results will be skipped
limit query integer true At most this many results are returned
name query string false Only return roles for a user, group or organization with this name.
shareRecipientType query string false List access controls for recipients with this type.
userBlueprintId path string true Used to identify a specific user-owned blueprint.

Enumerated Values

Parameter Value
shareRecipientType [user, group, organization]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "id": "string",
      "name": "string",
      "role": "CONSUMER",
      "shareRecipientType": "user"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK Successfully retrieved roles. UserBlueprintSharedRolesListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/userBlueprints/{userBlueprintId}/sharedRoles/

Share a user blueprint with a user, group, or organization

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/userBlueprints/{userBlueprintId}/sharedRoles/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "operation": "updateRoles",
  "roles": [
    {
      "role": "string",
      "shareRecipientType": "user",
      "username": "string"
    }
  ]
}

Parameters

Name In Type Required Description
userBlueprintId path string true Used to identify a specific user-owned blueprint.
body body SharedRolesUpdate false none

Responses

Status Meaning Description Schema
204 No Content Roles updated successfully None
400 Bad Request Bad Request None
403 Forbidden User can view entity but does not have permission to grant these roles on the entity. None
404 Not Found Either the entity does not exist or the user does not have permissions to view the entity. None
409 Conflict The request would leave the entity without an owner. None
422 Unprocessable Entity The request was formatted improperly. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/userBlueprintsBulkValidations/

Validate many user blueprints, optionally using a specific project. Any non-existent or inaccessible user blueprints will be ignored.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/userBlueprintsBulkValidations/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "projectId": "string",
  "userBlueprintIds": [
    "string"
  ]
}

Parameters

Name In Type Required Description
body body UserBlueprintBulkValidationRequest false none

Example responses

201 Response

{
  "data": [
    {
      "userBlueprintId": "string",
      "vertexContext": [
        {
          "information": {
            "inputs": [
              "string"
            ],
            "outputs": [
              "string"
            ]
          },
          "messages": {
            "errors": [
              "string"
            ],
            "warnings": [
              "string"
            ]
          },
          "taskId": "string"
        }
      ]
    }
  ]
}

Responses

Status Meaning Description Schema
201 Created Validated many user blueprints successfully UserBlueprintsBulkValidationResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Referenced project was not found. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/userBlueprintsInputTypes/

Retrieve the input types which can be used with User Blueprints.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/userBlueprintsInputTypes/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Example responses

200 Response

{
  "inputTypes": [
    {
      "name": "string",
      "type": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Successfully retrieved the input types. UserBlueprintsInputTypesResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/userBlueprintsProjectBlueprints/

Add a list of user blueprints, by id, to a specified (by id) project's repository.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/userBlueprintsProjectBlueprints/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "deleteAfter": false,
  "describeFailures": false,
  "projectId": "string",
  "userBlueprintIds": [
    "string"
  ]
}

Parameters

Name In Type Required Description
body body UserBlueprintAddToMenu false none

Example responses

200 Response

{
  "addedToMenu": [
    {
      "blueprintId": "string",
      "userBlueprintId": "string"
    }
  ],
  "message": "string",
  "notAddedToMenu": [
    {
      "error": "string",
      "userBlueprintId": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Successfully added the user blueprints to the project's repository. UserBlueprintAddToMenuResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Referenced project not found. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/userBlueprintsTaskParameters/

Validate that each value assigned to specified task parameters are valid.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/userBlueprintsTaskParameters/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "outputMethod": "P",
  "projectId": "string",
  "taskCode": "string",
  "taskParameters": [
    {
      "newValue": "string",
      "paramName": "string"
    }
  ]
}

Parameters

Name In Type Required Description
body body UserBlueprintTaskParameterValidation false none

Example responses

200 Response

{
  "errors": [
    {
      "message": "string",
      "paramName": "string",
      "value": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Accepted validation parameters for a task in the context of User Blueprints. UserBlueprintsValidateTaskParametersResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Custom task version not found None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/userBlueprintsTasks/

Retrieve the available tasks, organized into categories, which can be used to create or modify User Blueprints.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/userBlueprintsTasks/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
projectId query string false The project id to use for task retrieval
blueprintId query string false The blueprint id to use for task retrieval
userBlueprintId query string false The user blueprint id to use for task retrieval

Example responses

200 Response

{
  "categories": [
    {
      "name": "string",
      "subcategories": [
        {}
      ],
      "taskCodes": [
        "string"
      ]
    }
  ],
  "tasks": [
    {
      "taskCode": "string",
      "taskDefinition": {
        "arguments": [
          {
            "argument": {
              "default": "string",
              "name": "string",
              "recommended": "string",
              "tunable": true,
              "type": "string",
              "values": "string"
            },
            "key": "string"
          }
        ],
        "categories": [
          "string"
        ],
        "colnamesAndTypes": [
          {
            "colname": "string",
            "hex": "string",
            "type": "string"
          }
        ],
        "customTaskId": "string",
        "customTaskVersions": [
          {
            "id": "string",
            "label": "string",
            "versionMajor": 0,
            "versionMinor": 0
          }
        ],
        "description": "string",
        "icon": 0,
        "isCommonTask": false,
        "isCustomTask": true,
        "isVisibleInComposableMl": true,
        "label": "string",
        "outputMethods": [
          "string"
        ],
        "supportsScoringCode": true,
        "taskCode": "string",
        "timeSeriesOnly": true,
        "url": {},
        "validInputs": [
          "string"
        ]
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Successfully retrieved the tasks. UserBlueprintTasksResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Referenced project or user blueprint not found. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/userBlueprintsValidations/

Validate a user blueprint

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/userBlueprintsValidations/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "isInplaceEditor": false,
  "projectId": "string"
}

Parameters

Name In Type Required Description
body body UserBlueprintValidation false none

Example responses

201 Response

{
  "vertexContext": [
    {
      "information": {
        "inputs": [
          "string"
        ],
        "outputs": [
          "string"
        ]
      },
      "messages": {
        "errors": [
          "string"
        ],
        "warnings": [
          "string"
        ]
      },
      "taskId": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
201 Created Validated the user blueprint successfully UserBlueprintsValidationResponse
401 Unauthorized User is not authorized. None
403 Forbidden User does not have access to this functionality. None
404 Not Found Referenced project not found. None
422 Unprocessable Entity Unprocessable Entity None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

Schemas

AllowExtra

{}

Parameters submitted by the user to the failed job

Properties

None

AzureServicePrincipalCredentials

{
  "azureTenantId": "string",
  "clientId": "string",
  "clientSecret": "string",
  "credentialType": "azure_service_principal"
}

Properties

Name Type Required Restrictions Description
azureTenantId string true Tenant ID of the Azure AD service principal.
clientId string true Client ID of the Azure AD service principal.
clientSecret string true Client Secret of the Azure AD service principal.
credentialType string true The type of these credentials, 'azure_service_principal' here.

Enumerated Values

Property Value
credentialType azure_service_principal

BasicCredentials

{
  "credentialType": "basic",
  "password": "string",
  "user": "string"
}

Properties

Name Type Required Restrictions Description
credentialType string true The type of these credentials, 'basic' here.
password string true The password for database authentication. The password is encrypted at rest and never saved / stored.
user string true The username for database authentication.

Enumerated Values

Property Value
credentialType basic

BasicDatasetDetailsResponse

{
  "categories": [
    "BATCH_PREDICTIONS"
  ],
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "dataPersisted": true,
  "datasetId": "string",
  "isDataEngineEligible": true,
  "isLatestVersion": true,
  "isSnapshot": true,
  "name": "string",
  "processingState": "COMPLETED",
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "timeSeriesProperties": {
    "isMostlyImputed": null
  },
  "versionId": "string"
}

Properties

Name Type Required Restrictions Description
categories [string] true An array of strings describing the intended use of the dataset.
createdBy string¦null true Username of the user who created the dataset.
creationDate string(date-time) true The date when the dataset was created.
dataPersisted boolean true If true, user is allowed to view extended data profile (which includes data statistics like min/max/median/mean, histogram, etc.) and download data. If false, download is not allowed and only the data schema (feature names and types) will be available.
datasetId string true The ID of this dataset.
isDataEngineEligible boolean true Whether this dataset can be a data source of a data engine query.
isLatestVersion boolean true Whether this dataset version is the latest version of this dataset.
isSnapshot boolean true Whether the dataset is an immutable snapshot of data which has previously been retrieved and saved to DataRobot.
name string true The name of this dataset in the catalog.
processingState string true Current ingestion process state of dataset.
sampleSize SampleSize false Ingest size to use during dataset registration. Default behavior is to ingest full dataset.
timeSeriesProperties TimeSeriesProperties true Properties related to time series data prep.
versionId string true The object ID of the catalog_version the dataset belongs to.

Enumerated Values

Property Value
processingState [COMPLETED, ERROR, RUNNING]

BasicDatasetWithSizeResponse

{
  "categories": [
    "BATCH_PREDICTIONS"
  ],
  "columnCount": 0,
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "dataPersisted": true,
  "datasetId": "string",
  "datasetSize": 0,
  "isDataEngineEligible": true,
  "isLatestVersion": true,
  "isSnapshot": true,
  "name": "string",
  "processingState": "COMPLETED",
  "rowCount": 0,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "timeSeriesProperties": {
    "isMostlyImputed": null
  },
  "versionId": "string"
}

Properties

Name Type Required Restrictions Description
categories [string] true An array of strings describing the intended use of the dataset.
columnCount integer true The number of columns in the dataset.
createdBy string¦null true Username of the user who created the dataset.
creationDate string(date-time) true The date when the dataset was created.
dataPersisted boolean true If true, user is allowed to view extended data profile (which includes data statistics like min/max/median/mean, histogram, etc.) and download data. If false, download is not allowed and only the data schema (feature names and types) will be available.
datasetId string true The ID of this dataset.
datasetSize integer true The size of the dataset as a CSV in bytes.
isDataEngineEligible boolean true Whether this dataset can be a data source of a data engine query.
isLatestVersion boolean true Whether this dataset version is the latest version of this dataset.
isSnapshot boolean true Whether the dataset is an immutable snapshot of data which has previously been retrieved and saved to DataRobot.
name string true The name of this dataset in the catalog.
processingState string true Current ingestion process state of dataset.
rowCount integer true The number of rows in the dataset.
sampleSize SampleSize false Ingest size to use during dataset registration. Default behavior is to ingest full dataset.
timeSeriesProperties TimeSeriesProperties true Properties related to time series data prep.
versionId string true The object ID of the catalog_version the dataset belongs to.

Enumerated Values

Property Value
processingState [COMPLETED, ERROR, RUNNING]

BpData

{
  "children": [
    {}
  ],
  "id": "string",
  "inputs": [
    "string"
  ],
  "output": "string",
  "taskMap": {},
  "taskParameters": "string",
  "tasks": [
    "string"
  ],
  "type": "string"
}

Properties

Name Type Required Restrictions Description
children [AllowExtra] false A nested dictionary representation of the blueprint DAG.
id string true The type of the node (e.g. "start", "input", "task").
inputs [string] false The inputs to the current node.
output any false Ids describing the destination of any outgoing edges.

oneOf

Name Type Required Restrictions Description
» anonymous string false Ids describing the destination of any outgoing edges.

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
taskMap AllowExtra true Parameters submitted by the user to the failed job
taskParameters string true A stringified JSON object describing the parameters and their values for a task.
tasks [string] true The task defining the current node.
type string true A unique id to represent the current node.

BulkCatalogAppendTagsPayload

{
  "action": "tag",
  "tags": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
action string true The action to execute on the datasets. Has to be 'tag' for this payload.
tags [string] true minItems: 1
The tags to append to the datasets. Tags will not be duplicated.

Enumerated Values

Property Value
action tag

BulkCatalogDeletePayload

{
  "action": "delete"
}

Properties

Name Type Required Restrictions Description
action string true The action to execute on the datasets. Has to be 'delete' for this payload.

Enumerated Values

Property Value
action delete

BulkCatalogSharePayload

{
  "action": "updateRoles",
  "applyGrantToLinkedObjects": false,
  "roles": [
    {
      "canShare": false,
      "canUseData": true,
      "name": "string",
      "role": "CONSUMER",
      "shareRecipientType": "user"
    }
  ]
}

Properties

Name Type Required Restrictions Description
action string true The action to execute on the datasets. Has to be 'updateRoles' for this payload.
applyGrantToLinkedObjects boolean false If true for any users being granted access to the dataset, grant the user read access to any linked objects such as DataSources and DataStores that may be used by this dataset. Ignored if no such objects are relevant for dataset. Will not result in access being lowered for a user if the user already has higher access to linked objects than read access. However, if the target user does not have sharing permissions to the linked object, they will be given sharing access without lowering existing permissions. May result in an error if user making call does not have sufficient permissions to complete grant. Default value is false.
roles [oneOf] true maxItems: 100
minItems: 1
An array of RoleRequest objects. May contain at most 100 such objects.

oneOf

Name Type Required Restrictions Description
» anonymous DatasetRolesWithNames false none

xor

Name Type Required Restrictions Description
» anonymous DatasetRolesWithId false none

Enumerated Values

Property Value
action updateRoles

BulkDatasetAction

{
  "datasetIds": [
    "string"
  ],
  "payload": {
    "action": "delete"
  }
}

Properties

Name Type Required Restrictions Description
datasetIds [string] true minItems: 1
The dataset IDs to execute the bulk action on.
payload any true indicate which action to run and with what parameters.

oneOf

Name Type Required Restrictions Description
» anonymous BulkCatalogDeletePayload false none

xor

Name Type Required Restrictions Description
» anonymous BulkCatalogAppendTagsPayload false none

xor

Name Type Required Restrictions Description
» anonymous BulkCatalogSharePayload false none

CatalogDetailsRetrieveResponse

{
  "createdAt": "2019-08-24T14:15:22Z",
  "createdBy": "string",
  "description": "string",
  "id": "string",
  "message": "string",
  "modifiedAt": "2019-08-24T14:15:22Z",
  "modifiedBy": "string",
  "name": "string",
  "status": "COMPLETED",
  "tags": [
    "string"
  ],
  "type": "unknown_dataset_type"
}

Properties

Name Type Required Restrictions Description
createdAt string(date-time) true The ISO 8601-formatted date and time indicating when this item was created in the catalog.
createdBy string true The full name or username of the user who added this item to the catalog.
description string¦null true Catalog item description.
id string true Catalog item ID.
message string¦null true Details of exception(s) raised during ingestion process, if any.
modifiedAt string(date-time) true The ISO 8601-formatted date and time indicating changes to the Info field(s) of this catalog item.
modifiedBy string true The full name or username of the user who last modified the Info field(s) of this catalog item.
name string true Catalog item name.
status string¦null true For datasets, the current ingestion process state of this catalog item.
tags [string] true List of catalog item tags in the lower case with no spaces.
type string true Catalog item type.

Enumerated Values

Property Value
status [COMPLETED, ERROR, RUNNING]
type [unknown_dataset_type, snapshot_dataset, remote_dataset, unknown_catalog_type, user_blueprint]

CatalogExtendedDetailsDataOriginResponse

{
  "canShareDatasetData": true,
  "canUseDatasetData": true,
  "catalogName": "string",
  "catalogType": "unknown_dataset_type",
  "dataEngineQueryId": "string",
  "dataOrigin": "string",
  "dataSourceId": "string",
  "description": "string",
  "error": "string",
  "id": "string",
  "infoCreationDate": "string",
  "infoCreatorFullName": "string",
  "infoModificationDate": "string",
  "infoModifierFullName": "string",
  "isDataEngineEligible": true,
  "isFirstVersion": true,
  "lastModificationDate": "string",
  "lastModifierFullName": "string",
  "originalName": "string",
  "processingState": 0,
  "projectsUsedInCount": 0,
  "recipeId": "string",
  "relevance": 0,
  "tags": [
    "string"
  ],
  "uri": "string",
  "userBlueprintId": "string"
}

Properties

Name Type Required Restrictions Description
canShareDatasetData boolean true Indicates if the dataset data can be shared.
canUseDatasetData boolean true Indicates if the dataset data can be used.
catalogName string true Catalog item name.
catalogType string true Catalog item type.
dataEngineQueryId string¦null true The ID of the catalog item data engine query.
dataOrigin string¦null true Data origin of the datasource for this catalog item.
dataSourceId string¦null true The ID of the catalog item data source.
description string¦null true Catalog item description.
error string¦null true The latest error of the catalog item.
id string true Catalog item ID.
infoCreationDate string true The creation date of the catalog item.
infoCreatorFullName string true The creator of the catalog item.
infoModificationDate string true The date when the dataset metadata was last modified. This field is only applicable if the catalog item is a dataset.
infoModifierFullName string¦null true The user that last modified the dataset metadata. This field is only applicable if the catalog item is a dataset.
isDataEngineEligible boolean true Indicates if the catalog item is eligible for use by the data engine.
isFirstVersion boolean false Indicates if the catalog item is the first version.
lastModificationDate string true The date when the catalog item was last modified.
lastModifierFullName string true The user that last modified the catalog item.
originalName string true Catalog item original name.
processingState integer¦null true The latest processing state of the catalog item.
projectsUsedInCount integer true The number of projects that use the catalog item.
recipeId string¦null true The ID of the catalog item recipe.
relevance number¦null true ElasticSearch score value or null if search done in Mongo.
tags [string] true List of catalog item tags in the lower case with no spaces.
uri string¦null true The URI to the datasource from which the catalog item was created, if it is a dataset.
userBlueprintId string¦null true The ID by which a user blueprint is referenced in User Blueprint API.

Enumerated Values

Property Value
catalogType [unknown_dataset_type, snapshot_dataset, remote_dataset, unknown_catalog_type, user_blueprint]

CatalogExtendedDetailsResponse

{
  "canShareDatasetData": true,
  "canUseDatasetData": true,
  "catalogName": "string",
  "catalogType": "unknown_dataset_type",
  "dataEngineQueryId": "string",
  "dataSourceId": "string",
  "description": "string",
  "error": "string",
  "id": "string",
  "infoCreationDate": "string",
  "infoCreatorFullName": "string",
  "infoModificationDate": "string",
  "infoModifierFullName": "string",
  "isDataEngineEligible": true,
  "isFirstVersion": true,
  "lastModificationDate": "string",
  "lastModifierFullName": "string",
  "originalName": "string",
  "processingState": 0,
  "projectsUsedInCount": 0,
  "recipeId": "string",
  "relevance": 0,
  "tags": [
    "string"
  ],
  "uri": "string",
  "userBlueprintId": "string"
}

Properties

Name Type Required Restrictions Description
canShareDatasetData boolean true Indicates if the dataset data can be shared.
canUseDatasetData boolean true Indicates if the dataset data can be used.
catalogName string true Catalog item name.
catalogType string true Catalog item type.
dataEngineQueryId string¦null true The ID of the catalog item data engine query.
dataSourceId string¦null true The ID of the catalog item data source.
description string¦null true Catalog item description.
error string¦null true The latest error of the catalog item.
id string true Catalog item ID.
infoCreationDate string true The creation date of the catalog item.
infoCreatorFullName string true The creator of the catalog item.
infoModificationDate string true The date when the dataset metadata was last modified. This field is only applicable if the catalog item is a dataset.
infoModifierFullName string¦null true The user that last modified the dataset metadata. This field is only applicable if the catalog item is a dataset.
isDataEngineEligible boolean true Indicates if the catalog item is eligible for use by the data engine.
isFirstVersion boolean false Indicates if the catalog item is the first version.
lastModificationDate string true The date when the catalog item was last modified.
lastModifierFullName string true The user that last modified the catalog item.
originalName string true Catalog item original name.
processingState integer¦null true The latest processing state of the catalog item.
projectsUsedInCount integer true The number of projects that use the catalog item.
recipeId string¦null true The ID of the catalog item recipe.
relevance number¦null true ElasticSearch score value or null if search done in Mongo.
tags [string] true List of catalog item tags in the lower case with no spaces.
uri string¦null true The URI to the datasource from which the catalog item was created, if it is a dataset.
userBlueprintId string¦null true The ID by which a user blueprint is referenced in User Blueprint API.

Enumerated Values

Property Value
catalogType [unknown_dataset_type, snapshot_dataset, remote_dataset, unknown_catalog_type, user_blueprint]

CatalogListSearchResponse

{
  "cacheHit": true,
  "count": 0,
  "data": [
    {
      "canShareDatasetData": true,
      "canUseDatasetData": true,
      "catalogName": "string",
      "catalogType": "unknown_dataset_type",
      "dataEngineQueryId": "string",
      "dataOrigin": "string",
      "dataSourceId": "string",
      "description": "string",
      "error": "string",
      "id": "string",
      "infoCreationDate": "string",
      "infoCreatorFullName": "string",
      "infoModificationDate": "string",
      "infoModifierFullName": "string",
      "isDataEngineEligible": true,
      "isFirstVersion": true,
      "lastModificationDate": "string",
      "lastModifierFullName": "string",
      "originalName": "string",
      "processingState": 0,
      "projectsUsedInCount": 0,
      "recipeId": "string",
      "relevance": 0,
      "tags": [
        "string"
      ],
      "uri": "string",
      "userBlueprintId": "string"
    }
  ],
  "next": "string",
  "previous": "string",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
cacheHit boolean¦null true Indicates if the catalog item is returned from the cache.
count integer true Number of catalog items returned on this page.
data [CatalogExtendedDetailsDataOriginResponse] true Detailed information for every found catalog item.
next string¦null true Location of the next page.
previous string¦null true Location of the previous page.
totalCount integer false Total number of catalog items.

ColnameAndType

{
  "colname": "string",
  "hex": "string",
  "type": "string"
}

Properties

Name Type Required Restrictions Description
colname string true The column name.
hex string true A safe hex representation of the column name.
type string true The data type of the column.

CreateDataEngineQueryGenerator

{
  "datasets": [
    {
      "alias": "string",
      "datasetId": "string",
      "datasetVersionId": "string"
    }
  ],
  "generatorSettings": {
    "datetimePartitionColumn": "string",
    "defaultCategoricalAggregationMethod": "last",
    "defaultNumericAggregationMethod": "mean",
    "defaultTextAggregationMethod": "concat",
    "endToSeriesMaxDatetime": true,
    "multiseriesIdColumns": [
      "string"
    ],
    "startFromSeriesMinDatetime": true,
    "target": "string",
    "timeStep": 0,
    "timeUnit": "DAY"
  },
  "generatorType": "TimeSeries"
}

Properties

Name Type Required Restrictions Description
datasets [DataEngineDataset] true maxItems: 32
Source datasets in the Data Engine workspace.
generatorSettings GeneratorSettings true Data engine generator settings of the given generator_type.
generatorType string true Type of data engine query generator

Enumerated Values

Property Value
generatorType TimeSeries

CreateFromRecipe

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "doSnapshot": true,
  "materializationDestination": {
    "catalog": "string",
    "schema": "string",
    "table": "string"
  },
  "name": "string",
  "persistDataAfterIngestion": true,
  "recipeId": "string",
  "useKerberos": false
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
credentialData any false The credentials to authenticate with the database, to be used instead of credential ID.

oneOf

Name Type Required Restrictions Description
» anonymous BasicCredentials false none

xor

Name Type Required Restrictions Description
» anonymous S3Credentials false none

xor

Name Type Required Restrictions Description
» anonymous OAuthCredentials false none

continued

Name Type Required Restrictions Description
credentialId string false The ID of the set of credentials to authenticate with the database.
doSnapshot boolean false If true, create a snapshot dataset; if false, create a remote dataset. Creating snapshots from non-file sources requires an additional permission, Enable Create Snapshot Data Source.
materializationDestination MaterializationDestination false Destination table information to create and materialize the recipe to. If None, the recipe will be materialized in DataRobot.
name string false Name to be assigned to new Dataset.
persistDataAfterIngestion boolean false If true, will enforce saving all data (for download and sampling) and will allow a user to view extended data profile (which includes data statistics like min/max/median/mean, histogram, etc.). If false, will not enforce saving data. The data schema (feature names and types) still will be available. Specifying this parameter to false and doSnapshot to true will result in an error.
recipeId string true The identifier for the Wrangling Recipe to use as the source of data.
useKerberos boolean false If true, use kerberos authentication for database authentication.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

CreateWorkspaceState

{
  "datasets": [
    {
      "alias": "string",
      "datasetId": "string",
      "datasetVersionId": "string"
    }
  ],
  "language": "SQL",
  "query": "string"
}

Properties

Name Type Required Restrictions Description
datasets [DataEngineDataset] false Source datasets in the Data Engine workspace.
language string true Language of the Data Engine query.
query string true maxLength: 64000
Actual body of the Data Engine query.

Enumerated Values

Property Value
language SQL

CreateWorkspaceStateFromQueryGenerator

{
  "datasetId": "string",
  "datasetVersionId": "string",
  "queryGeneratorId": "string"
}

Properties

Name Type Required Restrictions Description
datasetId string false The ID of the dataset.
datasetVersionId string false The ID of the dataset version.
queryGeneratorId string true The ID of the query generator.

CreatedDatasetDataEngineResponse

{
  "datasetId": "string",
  "datasetVersionId": "string",
  "statusId": "string"
}

Properties

Name Type Required Restrictions Description
datasetId string true ID of the output dataset item.
datasetVersionId string true ID of the output dataset version item.
statusId string true ID that can be used with GET /api/v2/status/{statusId}/ to poll for the testing job's status.

CreatedDatasetResponse

{
  "catalogId": "string",
  "catalogVersionId": "string",
  "statusId": "string"
}

Properties

Name Type Required Restrictions Description
catalogId string true The ID of the catalog entry.
catalogVersionId string true The ID of the latest version of the catalog entry.
statusId string true ID that can be used with GET /api/v2/status/{statusId}/ to poll for the testing job's status.

DataEngineDataset

{
  "alias": "string",
  "datasetId": "string",
  "datasetVersionId": "string"
}

Properties

Name Type Required Restrictions Description
alias string true Alias to be used as the table name.
datasetId string false The ID of the dataset.
datasetVersionId string false The ID of the dataset version.

DatabricksAccessTokenCredentials

{
  "credentialType": "databricks_access_token_account",
  "databricksAccessToken": "string"
}

Properties

Name Type Required Restrictions Description
credentialType string true The type of these credentials, 'databricks_access_token_account' here.
databricksAccessToken string true minLength: 1
minLength: 1
Databricks personal access token.

Enumerated Values

Property Value
credentialType databricks_access_token_account

DatabricksServicePrincipalCredentials

{
  "clientId": "string",
  "clientSecret": "string",
  "configId": "string",
  "credentialType": "databricks_service_principal_account"
}

Properties

Name Type Required Restrictions Description
clientId string false minLength: 1
minLength: 1
Client ID for Databricks service principal.
clientSecret string false minLength: 1
minLength: 1
Client secret for Databricks service principal.
configId string false The ID of the saved shared credentials. If specified, cannot include clientIdand clientSecret.
credentialType string true The type of these credentials, 'databricks_service_principal_account' here.

Enumerated Values

Property Value
credentialType databricks_service_principal_account

DatasetAccessControlListResponse

{
  "count": 0,
  "data": [
    {
      "canShare": true,
      "canUseData": true,
      "role": "OWNER",
      "userFullName": "string",
      "username": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetAccessControlResponse] true An array of DatasetAccessControl objects.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetAccessControlResponse

{
  "canShare": true,
  "canUseData": true,
  "role": "OWNER",
  "userFullName": "string",
  "username": "string"
}

Properties

Name Type Required Restrictions Description
canShare boolean true True if this user can share with other users
canUseData boolean true True if the user can view, download and process data (use to create projects, predictions, etc)
role string true The role of the user on this data source.
userFullName string true The full name of a user with access to this dataset. If the full name is not available, username is returned instead.
username string true username of a user with access to this dataset.

Enumerated Values

Property Value
role [OWNER, EDITOR, CONSUMER]

DatasetAccessInner

{
  "canShare": true,
  "canUseData": true,
  "role": "CONSUMER",
  "username": "string"
}

Properties

Name Type Required Restrictions Description
canShare boolean false whether the user should be able to share with other users. If true, the user will be able to grant any role up to and including their own to other users. If role is empty canShare is ignored.
canUseData boolean false Whether the user should be able to view, download and process data (use to create projects, predictions, etc). For OWNER canUseData is always True. If role is empty canUseData is ignored.
role string true the role to grant to the user, or "" (empty string) to remove the users access
username string true username of the user to update the access role for.

Enumerated Values

Property Value
role [CONSUMER, EDITOR, OWNER, ``]

DatasetAccessSet

{
  "applyGrantToLinkedObjects": false,
  "data": [
    {
      "canShare": true,
      "canUseData": true,
      "role": "CONSUMER",
      "username": "string"
    }
  ]
}

Properties

Name Type Required Restrictions Description
applyGrantToLinkedObjects boolean false If true for any users being granted access to the dataset, grant the user read access to any linked objects such as DataSources and DataStores that may be used by this dataset. Ignored if no such objects are relevant for dataset. Will not result in access being lowered for a user if the user already has higher access to linked objects than read access. However, if the target user does not have sharing permissions to the linked object, they will be given sharing access without lowering existing permissions. May result in an error if user making call does not have sufficient permissions to complete grant. Default value is false.
data [DatasetAccessInner] true minItems: 1
array of DatasetAccessControl objects.

DatasetCreateFromWorkspaceState

{
  "credentials": "string",
  "datasetName": "string",
  "doSnapshot": true,
  "workspaceStateId": "string"
}

Properties

Name Type Required Restrictions Description
credentials string false JDBC credentials.
datasetName string false Custom name for the created dataset.
doSnapshot boolean false If true, create a snapshot dataset; if false, create a remote dataset. Creating snapshots from non-file sources requires an additional permission, Enable Create Snapshot Data Source.
workspaceStateId string true ID of the workspace state to use as the source of data.

DatasetCreateVersionFromWorkspaceState

{
  "credentials": "string",
  "doSnapshot": true,
  "workspaceStateId": "string"
}

Properties

Name Type Required Restrictions Description
credentials string false JDBC credentials.
doSnapshot boolean false If true, create a snapshot dataset; if false, create a remote dataset. Creating snapshots from non-file sources requires an additional permission, Enable Create Snapshot Data Source.
workspaceStateId string true ID of the workspace state to use as the source of data.

DatasetDescribePermissionsResponse

{
  "canCreateFeaturelist": true,
  "canDeleteDataset": true,
  "canDownloadDatasetData": true,
  "canGetCatalogItemInfo": true,
  "canGetDatasetInfo": true,
  "canGetDatasetPermissions": true,
  "canGetFeatureInfo": true,
  "canGetFeaturelists": true,
  "canPatchCatalogInfo": true,
  "canPatchDatasetAliases": true,
  "canPatchDatasetInfo": true,
  "canPatchDatasetPermissions": true,
  "canPatchFeaturelists": true,
  "canPostDataset": true,
  "canReloadDataset": true,
  "canShareDataset": true,
  "canSnapshotDataset": true,
  "canUndeleteDataset": true,
  "canUseDatasetData": true,
  "canUseFeaturelists": true,
  "datasetId": "string",
  "uid": "string",
  "username": "string"
}

Properties

Name Type Required Restrictions Description
canCreateFeaturelist boolean true True if the user can create a new featurelist for this dataset.
canDeleteDataset boolean true True if the user can delete dataset.
canDownloadDatasetData boolean true True if the user can download data.
canGetCatalogItemInfo boolean true True if the user can view catalog info.
canGetDatasetInfo boolean true True if the user can view dataset info.
canGetDatasetPermissions boolean true True if the user can view dataset permissions.
canGetFeatureInfo boolean true True if the user can retrieve feature info of dataset.
canGetFeaturelists boolean true True if the user can view featurelist for this dataset.
canPatchCatalogInfo boolean true True if the user can modify catalog info.
canPatchDatasetAliases boolean true True if the user can modify dataset feature aliases.
canPatchDatasetInfo boolean true True if the user can modify dataset info.
canPatchDatasetPermissions boolean true True if the user can modify dataset permissions.
canPatchFeaturelists boolean true True if the user can modify featurelists for this dataset.
canPostDataset boolean true True if the user can create a new dataset.
canReloadDataset boolean true True if the user can reload dataset.
canShareDataset boolean true True if the user can share the dataset.
canSnapshotDataset boolean true True if the user can save snapshot of dataset.
canUndeleteDataset boolean true True if the user can undelete dataset.
canUseDatasetData boolean true True if the user can use dataset data to create projects, train custom models or provide predictions.
canUseFeaturelists boolean true True if the user can use featurelists for this dataset. (for project creation)
datasetId string true The ID of the dataset.
uid string true The ID of the user identified by username.
username string true username of a user with access to this dataset.

DatasetFeatureHistogramResponse

{
  "plot": [
    {
      "count": 0,
      "label": "string"
    }
  ]
}

Properties

Name Type Required Restrictions Description
plot [DatasetFeaturePlotDataResponse] true Plot data based on feature values.

DatasetFeaturePlotDataResponse

{
  "count": 0,
  "label": "string"
}

Properties

Name Type Required Restrictions Description
count number true Number of values in the bin.
label string true Bin start for numerical/uncapped, or string value for categorical. The bin ==Missing== is created for rows that did not have the feature.

DatasetFeatureResponse

{
  "datasetId": "string",
  "datasetVersionId": "string",
  "dateFormat": "string",
  "featureType": "Boolean",
  "id": 0,
  "isZeroInflated": true,
  "keySummary": {
    "key": "string",
    "summary": {
      "dataQualities": "ISSUES_FOUND",
      "max": 0,
      "mean": 0,
      "median": 0,
      "min": 0,
      "pctRows": 0,
      "stdDev": 0
    }
  },
  "language": "string",
  "lowInformation": true,
  "max": 0,
  "mean": 0,
  "median": 0,
  "min": 0,
  "naCount": 0,
  "name": "string",
  "plot": [
    {
      "count": 0,
      "label": "string"
    }
  ],
  "stdDev": 0,
  "timeSeriesEligibilityReason": "string",
  "timeSeriesEligibilityReasonAggregation": "string",
  "timeSeriesEligible": true,
  "timeSeriesEligibleAggregation": true,
  "timeStep": 0,
  "timeStepAggregation": 0,
  "timeUnit": "string",
  "timeUnitAggregation": "string",
  "uniqueCount": 0
}

Properties

Name Type Required Restrictions Description
datasetId string true The ID of the dataset the feature belongs to
datasetVersionId string true The ID of the dataset version the feature belongs to.
dateFormat string¦null true The date format string for how this feature was interpreted (or null if not a date feature). If not null, it will be compatible with https://docs.python.org/2/library/time.html#time.strftime .
featureType string true Feature type.
id integer true The number of the column in the dataset.
isZeroInflated boolean¦null false whether feature has an excessive number of zeros
keySummary any false Per key summaries for Summarized Categorical or Multicategorical columns

oneOf

Name Type Required Restrictions Description
» anonymous FeatureKeySummaryResponseValidatorSummarizedCategorical false For a Summarized Categorical columns, this will contain statistics for the top 50 keys (truncated to 103 characters)

xor

Name Type Required Restrictions Description
» anonymous [FeatureKeySummaryResponseValidatorMultilabel] false For a Multicategorical columns, this will contain statistics for the top classes

continued

Name Type Required Restrictions Description
language string false Detected language of the feature.
lowInformation boolean false Whether feature has too few values to be informative.
max number¦null false Maximum value of the EDA sample of the feature.
mean number¦null false Arithmetic mean of the EDA sample of the feature.
median number¦null false Median of the EDA sample of the feature.
min number¦null false Minimum value of the EDA sample of the feature.
naCount integer¦null false Number of missing values.
name string true Feature name
plot [DatasetFeaturePlotDataResponse]¦null false Plot data based on feature values.
stdDev number¦null false Standard deviation of EDA sample of the feature.
timeSeriesEligibilityReason string¦null false why the feature is ineligible for time series projects, or 'suitable' if it is eligible.
timeSeriesEligibilityReasonAggregation string¦null false why the feature is ineligible for aggregation, or 'suitable' if it is eligible.
timeSeriesEligible boolean false whether this feature can be used as a datetime partitioning feature for time series projects. Only sufficiently regular date features can be selected as the datetime feature for time series projects. Always false for non-date features. Date features that cannot be used in datetime partitioning for a time series project may be eligible for an OTV project, which has less stringent requirements.
timeSeriesEligibleAggregation boolean false whether this feature can be used as a datetime feature for aggregationfor time series data prep. Always false for non-date features.
timeStep integer¦null false The minimum time step that can be used to specify time series windows. The units for this value are the timeUnit. When specifying windows for time series projects, all windows must have durations that are integer multiples of this number. Only present for date features that are eligible for time series projects and null otherwise.
timeStepAggregation integer¦null false The minimum time step that can be used to aggregate using this feature for time series data prep. The units for this value are the timeUnit. Only present for date features that are eligible for aggregation in time series data prep and null otherwise.
timeUnit string¦null false The unit for the interval between values of this feature, e.g. DAY, MONTH, HOUR. When specifying windows for time series projects, the windows are expressed in terms of this unit. Only present for date features eligible for time series projects, and null otherwise.
timeUnitAggregation string¦null false The unit for the interval between values of this feature, e.g. DAY, MONTH, HOUR. Only present for date features eligible for aggregation, and null otherwise.
uniqueCount integer¦null false Number of unique values.

Enumerated Values

Property Value
featureType [Boolean, Categorical, Currency, Date, Date Duration, Document, Image, Interaction, Length, Location, Multicategorical, Numeric, Percentage, Summarized Categorical, Text, Time]

DatasetFeaturelistListResponse

{
  "count": 0,
  "data": [
    {
      "createdBy": "string",
      "creationDate": "2019-08-24T14:15:22Z",
      "datasetId": "string",
      "datasetVersionId": "string",
      "features": [
        "string"
      ],
      "id": "string",
      "name": "string",
      "userCreated": true
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetFeaturelistResponse] true An array of featurelists' details.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetFeaturelistResponse

{
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "datasetId": "string",
  "datasetVersionId": "string",
  "features": [
    "string"
  ],
  "id": "string",
  "name": "string",
  "userCreated": true
}

Properties

Name Type Required Restrictions Description
createdBy string¦null true username of the user who created the dataset.
creationDate string(date-time) true the ISO 8601 formatted date and time when the dataset was created.
datasetId string true The ID of the dataset.
datasetVersionId string¦null true The ID of the dataset version if the featurelist is associated with a specific dataset version, for example Informative Features, or null otherwise.
features [string] true Features in the featurelist.
id string true The ID of the featurelist
name string true The name of the featurelist
userCreated boolean true True if the featurelist was created by a user vs the system.

DatasetFeaturesListResponse

{
  "count": 0,
  "data": [
    {
      "datasetId": "string",
      "datasetVersionId": "string",
      "dateFormat": "string",
      "featureType": "Boolean",
      "id": 0,
      "isZeroInflated": true,
      "keySummary": {
        "key": "string",
        "summary": {
          "dataQualities": "ISSUES_FOUND",
          "max": 0,
          "mean": 0,
          "median": 0,
          "min": 0,
          "pctRows": 0,
          "stdDev": 0
        }
      },
      "language": "string",
      "lowInformation": true,
      "max": 0,
      "mean": 0,
      "median": 0,
      "min": 0,
      "naCount": 0,
      "name": "string",
      "plot": [
        {
          "count": 0,
          "label": "string"
        }
      ],
      "stdDev": 0,
      "timeSeriesEligibilityReason": "string",
      "timeSeriesEligibilityReasonAggregation": "string",
      "timeSeriesEligible": true,
      "timeSeriesEligibleAggregation": true,
      "timeStep": 0,
      "timeStepAggregation": 0,
      "timeUnit": "string",
      "timeUnitAggregation": "string",
      "uniqueCount": 0
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetFeatureResponse] true The list of features related to the requested dataset.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetFromFile

{
  "categories": "BATCH_PREDICTIONS",
  "file": "string"
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
file string(binary) true The data to be used for the creation.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

DatasetListResponse

{
  "count": 0,
  "data": [
    {
      "categories": [
        "BATCH_PREDICTIONS"
      ],
      "columnCount": 0,
      "createdBy": "string",
      "creationDate": "2019-08-24T14:15:22Z",
      "dataPersisted": true,
      "datasetId": "string",
      "datasetSize": 0,
      "isDataEngineEligible": true,
      "isLatestVersion": true,
      "isSnapshot": true,
      "name": "string",
      "processingState": "COMPLETED",
      "rowCount": 0,
      "sampleSize": {
        "type": "rows",
        "value": 0
      },
      "timeSeriesProperties": {
        "isMostlyImputed": null
      },
      "versionId": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [BasicDatasetWithSizeResponse] true An array of dataset details.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetProject

{
  "id": "string",
  "url": "string"
}

Properties

Name Type Required Restrictions Description
id string true The dataset's project ID.
url string true The link to retrieve more information about the dataset version's project.

DatasetProjectListResponse

{
  "count": 0,
  "data": [
    {
      "id": "string",
      "url": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetProjectResponse] true An array of information about dataset's projects
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetProjectResponse

{
  "id": "string",
  "url": "string"
}

Properties

Name Type Required Restrictions Description
id string true The dataset's project ID.
url string true The link to retrieve more information about the dataset's project.

DatasetRefresh

{
  "dayOfMonth": [
    "*"
  ],
  "dayOfWeek": [
    "*"
  ],
  "hour": [
    "*"
  ],
  "minute": [
    "*"
  ],
  "month": [
    "*"
  ]
}

Schedule describing when to refresh the dataset. The smallest schedule allowed is daily.

Properties

Name Type Required Restrictions Description
dayOfMonth [anyOf] false The date(s) of the month that the job will run. Allowed values are either [1 ... 31] or ["*"] for all days of the month. This field is additive with dayOfWeek, meaning the job will run both on the date(s) defined in this field and the day specified by dayOfWeek (for example, dates 1st, 2nd, 3rd, plus every Tuesday). If dayOfMonth is set to ["*"] and dayOfWeek is defined, the scheduler will trigger on every day of the month that matches dayOfWeek (for example, Tuesday the 2nd, 9th, 16th, 23rd, 30th). Invalid dates such as February 31st are ignored.

anyOf

Name Type Required Restrictions Description
» anonymous number false none

or

Name Type Required Restrictions Description
» anonymous string false none

continued

Name Type Required Restrictions Description
dayOfWeek [anyOf] false The day(s) of the week that the job will run. Allowed values are [0 .. 6], where (Sunday=0), or ["*"], for all days of the week. Strings, either 3-letter abbreviations or the full name of the day, can be used interchangeably (e.g., "sunday", "Sunday", "sun", or "Sun", all map to [0]. This field is additive with dayOfMonth, meaning the job will run both on the date specified by dayOfMonth and the day defined in this field.

anyOf

Name Type Required Restrictions Description
» anonymous number false none

or

Name Type Required Restrictions Description
» anonymous string false none

continued

Name Type Required Restrictions Description
hour any false The hour(s) of the day that the job will run. Allowed values are [0 ... 23].

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
minute any false The minute(s) of the day that the job will run. Allowed values are [0 ... 59].

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
month [anyOf] false The month(s) of the year that the job will run. Allowed values are either [1 ... 12] or ["*"] for all months of the year. Strings, either 3-letter abbreviations or the full name of the month, can be used interchangeably (e.g., "jan" or "october"). Months that are not compatible with dayOfMonth are ignored, for example {"dayOfMonth": [31], "month":["feb"]}.

anyOf

Name Type Required Restrictions Description
» anonymous number false none

or

Name Type Required Restrictions Description
» anonymous string false none

Enumerated Values

Property Value
anonymous [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]
anonymous [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59]

DatasetRefreshExecutionResult

{
  "completedAt": "2019-08-24T14:15:22Z",
  "datasetId": "string",
  "datasetVersionId": "string",
  "executionId": "string",
  "jobId": "string",
  "message": "string",
  "startedAt": "2019-08-24T14:15:22Z",
  "status": "INITIALIZING"
}

Properties

Name Type Required Restrictions Description
completedAt string(date-time) true UTC completion date, in RFC-3339 format.
datasetId string true Dataset ID associated with this result.
datasetVersionId string true Dataset version ID associated with this result
executionId string true Result ID.
jobId string true Job ID associated with this result.
message string true Current status of execution.
startedAt string(date-time) true UTC start date, in RFC-3339 format.
status string true Status of this dataset refresh.

Enumerated Values

Property Value
status [INITIALIZING, REFRESHING, SUCCESS, ERROR]

DatasetRefreshJobCreate

{
  "categories": "BATCH_PREDICTIONS",
  "credentialId": null,
  "credentials": "string",
  "enabled": true,
  "name": "string",
  "schedule": {
    "dayOfMonth": [
      "*"
    ],
    "dayOfWeek": [
      "*"
    ],
    "hour": [
      "*"
    ],
    "minute": [
      "*"
    ],
    "month": [
      "*"
    ]
  },
  "scheduleReferenceDate": "2019-08-24T14:15:22Z",
  "useKerberos": false
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset. The supported options are TRAINING, and PREDICTION.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
credentialId string¦null false The ID of the set of credentials to use to run the scheduled job when the Kerberos authentication service is utilized. Required when useKerberos is true.
credentials string false A JSON string describing the data engine queries credentials to use when refreshing.
enabled boolean false Boolean for whether the scheduled job is active (true) or inactive (false).
name string true maxLength: 256
Scheduled job name.
schedule DatasetRefresh true Schedule describing when to refresh the dataset. The smallest schedule allowed is daily.
scheduleReferenceDate string(date-time) false The UTC reference date in RFC-3339 format of when the schedule starts from. This value is returned in /api/v2/datasets/(datasetId)/refreshJobs/(jobId)/ to help build a more intuitive schedule picker. The default is the current time.
useKerberos boolean false If true, the Kerberos authentication system is used in conjunction with a credential ID.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

DatasetRefreshJobResponse

{
  "categories": "BATCH_PREDICTIONS",
  "createdBy": "string",
  "credentialId": "string",
  "credentials": "string",
  "datasetId": "string",
  "enabled": true,
  "jobId": "string",
  "name": "string",
  "schedule": {
    "dayOfMonth": [
      "*"
    ],
    "dayOfWeek": [
      "*"
    ],
    "hour": [
      "*"
    ],
    "minute": [
      "*"
    ],
    "month": [
      "*"
    ]
  },
  "scheduleReferenceDate": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "updatedBy": "string",
  "useKerberos": true
}

Properties

Name Type Required Restrictions Description
categories any true An array of strings describing the intended use of the dataset.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
createdBy string true The user who created this dataset refresh job.
credentialId string¦null true ID used to validate with Kerberos authentication service if Kerberos is enabled.
credentials string true A JSON string describing the data engine queries credentials to use when refreshing.
datasetId string true ID of the dataset the user scheduled job applies to.
enabled boolean true Indicates whether the scheduled job is active (true) or inactive(false).
jobId string true The scheduled job ID.
name string true The scheduled job's name.
schedule DatasetRefresh true Schedule describing when to refresh the dataset. The smallest schedule allowed is daily.
scheduleReferenceDate string(date-time) true The UTC reference date in RFC-3339 format of when the schedule starts from. Can be used to help build a more intuitive schedule picker.
updatedAt string(date-time) true The UTC date in RFC-3339 format of when the job was last updated.
updatedBy string true The user who last modified this dataset refresh job.
useKerberos boolean true Boolean (true) if the Kerberos authentication service is needed when refreshing a job.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

DatasetRefreshJobRetrieveExecutionResultsResponse

{
  "count": 0,
  "data": [
    {
      "completedAt": "2019-08-24T14:15:22Z",
      "datasetId": "string",
      "datasetVersionId": "string",
      "executionId": "string",
      "jobId": "string",
      "message": "string",
      "startedAt": "2019-08-24T14:15:22Z",
      "status": "INITIALIZING"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetRefreshExecutionResult] true Array of dataset refresh results, returned latest first.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetRefreshJobUpdate

{
  "categories": "BATCH_PREDICTIONS",
  "credentialId": "string",
  "credentials": "string",
  "enabled": true,
  "name": "string",
  "schedule": {
    "dayOfMonth": [
      "*"
    ],
    "dayOfWeek": [
      "*"
    ],
    "hour": [
      "*"
    ],
    "minute": [
      "*"
    ],
    "month": [
      "*"
    ]
  },
  "scheduleReferenceDate": "2019-08-24T14:15:22Z",
  "useKerberos": true
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset. The supported options are TRAINING, and PREDICTION.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
credentialId string¦null false The ID of the set of credentials to use to run the scheduled job when the Kerberos authentication service is utilized. Required when useKerberos is true.
credentials string false A JSON string describing the data engine queries credentials to use when refreshing.
enabled boolean false Boolean for whether the scheduled job is active (true) or inactive (false).
name string false maxLength: 256
Scheduled job name.
schedule DatasetRefresh false Schedule describing when to refresh the dataset. The smallest schedule allowed is daily.
scheduleReferenceDate string(date-time) false The UTC reference date in RFC-3339 format of when the schedule starts from. This value is returned in /api/v2/datasets/(datasetId)/refreshJobs/(jobId)/ to help build a more intuitive schedule picker. Required when schedule is being updated. The default is the current time.
useKerberos boolean false If true, the Kerberos authentication system is used in conjunction with a credential ID.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

DatasetRefreshJobsListResponse

{
  "count": 0,
  "data": [
    {
      "categories": "BATCH_PREDICTIONS",
      "createdBy": "string",
      "credentialId": "string",
      "credentials": "string",
      "datasetId": "string",
      "enabled": true,
      "jobId": "string",
      "name": "string",
      "schedule": {
        "dayOfMonth": [
          "*"
        ],
        "dayOfWeek": [
          "*"
        ],
        "hour": [
          "*"
        ],
        "minute": [
          "*"
        ],
        "month": [
          "*"
        ]
      },
      "scheduleReferenceDate": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "updatedBy": "string",
      "useKerberos": true
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetRefreshJobResponse] true An array of information about scheduled dataset refresh jobs. Results are based on updatedAt value and returned in descending order (latest returned first).
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetRelationshipCreate

{
  "linkedDatasetId": "string",
  "linkedFeatures": [
    "string"
  ],
  "sourceFeatures": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
linkedDatasetId string true The ID of another dataset with which to create relationships.
linkedFeatures [string] true minItems: 1
List of features belonging to the linked dataset.
sourceFeatures [string] true minItems: 1
List of features belonging to the source dataset.

DatasetRelationshipListResponse

{
  "count": 0,
  "data": [
    {
      "createdBy": "string",
      "creationDate": "2019-08-24T14:15:22Z",
      "id": "string",
      "linkedDatasetId": "string",
      "linkedFeatures": [
        "string"
      ],
      "modificationDate": "2019-08-24T14:15:22Z",
      "modifiedBy": "string",
      "sourceDatasetId": "string",
      "sourceFeatures": [
        "string"
      ]
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetRelationshipResponse] true An array of relationships' details.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetRelationshipResponse

{
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "id": "string",
  "linkedDatasetId": "string",
  "linkedFeatures": [
    "string"
  ],
  "modificationDate": "2019-08-24T14:15:22Z",
  "modifiedBy": "string",
  "sourceDatasetId": "string",
  "sourceFeatures": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
createdBy string true The username of the user that created this relationship.
creationDate string(date-time) true ISO-8601 formatted time/date that this record was created.
id string true ID of the dataset relationship
linkedDatasetId string true ID of the linked dataset.
linkedFeatures [string] true List of features belonging to the linked dataset.
modificationDate string(date-time) true ISO-8601 formatted time/date that this record was last updated.
modifiedBy string true The username of the user that modified this relationship most recently.
sourceDatasetId string true ID of the source dataset.
sourceFeatures [string] true List of features belonging to the source dataset.

DatasetRelationshipUpdate

{
  "linkedDatasetId": "string",
  "linkedFeatures": [
    "string"
  ],
  "sourceFeatures": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
linkedDatasetId string false id of another dataset with which to create relationships
linkedFeatures [string] false minItems: 1
list of features belonging to the linked dataset
sourceFeatures [string] false minItems: 1
list of features belonging to the source dataset

DatasetRolesWithId

{
  "canShare": false,
  "canUseData": true,
  "id": "string",
  "role": "CONSUMER",
  "shareRecipientType": "user"
}

Properties

Name Type Required Restrictions Description
canShare boolean false Whether the org/group/user should be able to share with others. If true, the org/group/user will be able to grant any role up to and including their own to other orgs/groups/user. If role is NO_ROLE canShare is ignored.
canUseData boolean false Whether the user/group/org should be able to view, download and process data (use to create projects, predictions, etc). For OWNER canUseData is always True. If role is empty canUseData is ignored.
id string true The org/group/user ID.
role string true The role of the org/group/user on this dataset or "NO_ROLE" for removing access when used with route to modify access.
shareRecipientType string true It describes the recipient type.

Enumerated Values

Property Value
role [CONSUMER, EDITOR, OWNER, NO_ROLE]
shareRecipientType [user, group, organization]

DatasetRolesWithNames

{
  "canShare": false,
  "canUseData": true,
  "name": "string",
  "role": "CONSUMER",
  "shareRecipientType": "user"
}

Properties

Name Type Required Restrictions Description
canShare boolean false Whether the org/group/user should be able to share with others. If true, the org/group/user will be able to grant any role up to and including their own to other orgs/groups/user. If role is NO_ROLE canShare is ignored.
canUseData boolean false Whether the user/group/org should be able to view, download and process data (use to create projects, predictions, etc). For OWNER canUseData is always True. If role is empty canUseData is ignored.
name string true Name of the user/group/org to update the access role for.
role string true The role of the org/group/user on this dataset or "NO_ROLE" for removing access when used with route to modify access.
shareRecipientType string true It describes the recipient type.

Enumerated Values

Property Value
role [CONSUMER, EDITOR, OWNER, NO_ROLE]
shareRecipientType [user, group, organization]

DatasetSharedRoles

{
  "applyGrantToLinkedObjects": false,
  "operation": "updateRoles",
  "roles": [
    {
      "canShare": false,
      "canUseData": true,
      "name": "string",
      "role": "CONSUMER",
      "shareRecipientType": "user"
    }
  ]
}

Properties

Name Type Required Restrictions Description
applyGrantToLinkedObjects boolean false If true for any users being granted access to the dataset, grant the user read access to any linked objects such as DataSources and DataStores that may be used by this dataset. Ignored if no such objects are relevant for dataset. Will not result in access being lowered for a user if the user already has higher access to linked objects than read access. However, if the target user does not have sharing permissions to the linked object, they will be given sharing access without lowering existing permissions. May result in an error if user making call does not have sufficient permissions to complete grant. Default value is false.
operation string true The name of the action being taken. The only operation is "updateRoles".
roles [oneOf] true maxItems: 100
minItems: 1
An array of RoleRequest objects. May contain at most 100 such objects.

oneOf

Name Type Required Restrictions Description
» anonymous DatasetRolesWithNames false none

xor

Name Type Required Restrictions Description
» anonymous DatasetRolesWithId false none

Enumerated Values

Property Value
operation updateRoles

DatasetTransformListResponse

{
  "count": 0,
  "data": [
    {
      "dateExtraction": "year",
      "name": "string",
      "parentName": "string",
      "replacement": "string",
      "variableType": "text"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetTransformResponse] true An array of transforms' details.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

DatasetTransformResponse

{
  "dateExtraction": "year",
  "name": "string",
  "parentName": "string",
  "replacement": "string",
  "variableType": "text"
}

Properties

Name Type Required Restrictions Description
dateExtraction string¦null true The value to extract from the date column.
name string true The feature name.
parentName string true The name of the parent feature.
replacement any true The replacement in case of a failed transformation.

anyOf

Name Type Required Restrictions Description
» anonymous string false none

or

Name Type Required Restrictions Description
» anonymous boolean false none

or

Name Type Required Restrictions Description
» anonymous number false none

or

Name Type Required Restrictions Description
» anonymous integer false none

continued

Name Type Required Restrictions Description
variableType string true The type of the transform.

Enumerated Values

Property Value
dateExtraction [year, yearDay, month, monthDay, week, weekDay]
variableType [text, categorical, numeric, categoricalInt]

Datasource

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "dataSourceId": "string",
  "doSnapshot": true,
  "password": "string",
  "persistDataAfterIngestion": true,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "useKerberos": false,
  "user": "string"
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
credentialData any false The credentials to authenticate with the database, to be used instead of credential ID.

oneOf

Name Type Required Restrictions Description
» anonymous BasicCredentials false none

xor

Name Type Required Restrictions Description
» anonymous S3Credentials false none

xor

Name Type Required Restrictions Description
» anonymous OAuthCredentials false none

xor

Name Type Required Restrictions Description
» anonymous SnowflakeKeyPairCredentials false none

xor

Name Type Required Restrictions Description
» anonymous GoogleServiceAccountCredentials false none

xor

Name Type Required Restrictions Description
» anonymous DatabricksAccessTokenCredentials false none

xor

Name Type Required Restrictions Description
» anonymous DatabricksServicePrincipalCredentials false none

xor

Name Type Required Restrictions Description
» anonymous AzureServicePrincipalCredentials false none

continued

Name Type Required Restrictions Description
credentialId string false The ID of the set of credentials to authenticate with the database.
dataSourceId string true The identifier for the DataSource to use as the source of data.
doSnapshot boolean false If true, create a snapshot dataset; if false, create a remote dataset. Creating snapshots from non-file sources requires an additional permission, Enable Create Snapshot Data Source.
password string false The password (in cleartext) for database authentication. The password will be encrypted on the server side in scope of HTTP request and never saved or stored. DEPRECATED: please use credentialId or credentialData instead.
persistDataAfterIngestion boolean false If true, will enforce saving all data (for download and sampling) and will allow a user to view extended data profile (which includes data statistics like min/max/median/mean, histogram, etc.). If false, will not enforce saving data. The data schema (feature names and types) still will be available. Specifying this parameter to false and doSnapshot to true will result in an error.
sampleSize SampleSize false Ingest size to use during dataset registration. Default behavior is to ingest full dataset.
useKerberos boolean false If true, use kerberos authentication for database authentication.
user string false The username for database authentication. DEPRECATED: please use credentialId or credentialData instead.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

EntityCountByTypeResponse

{
  "numCalendars": 0,
  "numExternalModelPackages": 0,
  "numFeatureDiscoveryConfigs": 0,
  "numPredictionDatasets": 0,
  "numProjects": 0,
  "numSparkSqlQueries": 0
}

Number of different type entities that use the dataset.

Properties

Name Type Required Restrictions Description
numCalendars integer true The number of calendars that use the dataset
numExternalModelPackages integer true The number of external model packages that use the dataset
numFeatureDiscoveryConfigs integer true The number of feature discovery configs that use the dataset
numPredictionDatasets integer true The number of prediction datasets that use the dataset
numProjects integer true The number of projects that use the dataset
numSparkSqlQueries integer true The number of spark sql queries that use the dataset

FeatureCountByTypeResponse

{
  "count": 0,
  "featureType": "string"
}

Properties

Name Type Required Restrictions Description
count integer true The number of features of this type in the dataset
featureType string true The data type grouped in this count

FeatureKeySummaryDetailsResponseValidatorMultilabel

{
  "max": 0,
  "mean": 0,
  "median": 0,
  "min": 0,
  "pctRows": 0,
  "stdDev": 0
}

Statistics of the key.

Properties

Name Type Required Restrictions Description
max number true Maximum value of the key.
mean number true Mean value of the key.
median number true Median value of the key.
min number true Minimum value of the key.
pctRows number true Percentage occurrence of key in the EDA sample of the feature.
stdDev number true Standard deviation of the key.

FeatureKeySummaryDetailsResponseValidatorSummarizedCategorical

{
  "dataQualities": "ISSUES_FOUND",
  "max": 0,
  "mean": 0,
  "median": 0,
  "min": 0,
  "pctRows": 0,
  "stdDev": 0
}

Statistics of the key.

Properties

Name Type Required Restrictions Description
dataQualities string true The indicator of data quality assessment of the feature.
max number true Maximum value of the key.
mean number true Mean value of the key.
median number true Median value of the key.
min number true Minimum value of the key.
pctRows number true Percentage occurrence of key in the EDA sample of the feature.
stdDev number true Standard deviation of the key.

Enumerated Values

Property Value
dataQualities [ISSUES_FOUND, NOT_ANALYZED, NO_ISSUES_FOUND]

FeatureKeySummaryResponseValidatorMultilabel

{
  "key": "string",
  "summary": {
    "max": 0,
    "mean": 0,
    "median": 0,
    "min": 0,
    "pctRows": 0,
    "stdDev": 0
  }
}

Properties

Name Type Required Restrictions Description
key string true Name of the key.
summary FeatureKeySummaryDetailsResponseValidatorMultilabel true Statistics of the key.

FeatureKeySummaryResponseValidatorSummarizedCategorical

{
  "key": "string",
  "summary": {
    "dataQualities": "ISSUES_FOUND",
    "max": 0,
    "mean": 0,
    "median": 0,
    "min": 0,
    "pctRows": 0,
    "stdDev": 0
  }
}

For a Summarized Categorical columns, this will contain statistics for the top 50 keys (truncated to 103 characters)

Properties

Name Type Required Restrictions Description
key string true Name of the key.
summary FeatureKeySummaryDetailsResponseValidatorSummarizedCategorical true Statistics of the key.

FeatureListCreate

{
  "description": "string",
  "features": [
    "string"
  ],
  "name": "string"
}

Properties

Name Type Required Restrictions Description
description string false Description of the featurelist
features [string] true minItems: 1
List of names of features to be included in the new featurelist, all features listed must be part of the universe. All features for this dataset for the request to succeed.
name string true Name of the featurelist to be created

FeatureListModify

{
  "description": "string",
  "name": "string"
}

Properties

Name Type Required Restrictions Description
description string¦null false The new description of the featurelist
name string false The new name of the featurelist.

FeatureTransform

{
  "dateExtraction": "year",
  "name": "string",
  "parentName": "string",
  "replacement": "string",
  "variableType": "text"
}

Properties

Name Type Required Restrictions Description
dateExtraction string false The value to extract from the date column, of these options: [year|yearDay|month|monthDay|week|weekDay]. Required for transformation of a date column. Otherwise must not be provided.
name string true The name of the new feature. Must not be the same as any existing features for this project. Must not contain '/' character.
parentName string true The name of the parent feature.
replacement any false The replacement in case of a failed transformation.

anyOf

Name Type Required Restrictions Description
» anonymous string¦null false none

or

Name Type Required Restrictions Description
» anonymous boolean¦null false none

or

Name Type Required Restrictions Description
» anonymous number¦null false none

or

Name Type Required Restrictions Description
» anonymous integer¦null false none

continued

Name Type Required Restrictions Description
variableType string true The type of the new feature. Must be one of text, categorical (Deprecated in version v2.21), numeric, or categoricalInt. See the description of this method for more information.

Enumerated Values

Property Value
dateExtraction [year, yearDay, month, monthDay, week, weekDay]
variableType [text, categorical, numeric, categoricalInt]

FromLatest

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "credentials": "string",
  "password": "string",
  "useKerberos": false,
  "useLatestSuccess": false,
  "user": "string"
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
credentialData any false The credentials to authenticate with the database, to be used instead of credential ID.

oneOf

Name Type Required Restrictions Description
» anonymous BasicCredentials false none

xor

Name Type Required Restrictions Description
» anonymous S3Credentials false none

xor

Name Type Required Restrictions Description
» anonymous OAuthCredentials false none

continued

Name Type Required Restrictions Description
credentialId string false The ID of the set of credentials to authenticate with the database.
credentials string false A list of credentials to use if this is a Spark dataset that requires credentials.
password string false The password (in cleartext) for database authentication. The password will be encrypted on the server-side HTTP request and never saved or stored. Required only if the previous data source was a data source. DEPRECATED: please use credentialId or credentialData instead.
useKerberos boolean false If true, use Kerberos for database authentication.
useLatestSuccess boolean false If true, use the latest version that was successfully ingested instead of the latest version, which might be in an errored state. If no successful version is present, the latest errored version is used and the operation fails.
user string false The username for database authentication. Required only if the dataset was initially created from a data source. DEPRECATED: please use credentialId or credentialData instead.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

FromSpecific

{
  "categories": "BATCH_PREDICTIONS",
  "credentialData": {
    "credentialType": "basic",
    "password": "string",
    "user": "string"
  },
  "credentialId": "string",
  "credentials": "string",
  "password": "string",
  "useKerberos": false,
  "user": "string"
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
credentialData any false The credentials to authenticate with the database, to be used instead of credential ID.

oneOf

Name Type Required Restrictions Description
» anonymous BasicCredentials false none

xor

Name Type Required Restrictions Description
» anonymous S3Credentials false none

xor

Name Type Required Restrictions Description
» anonymous OAuthCredentials false none

continued

Name Type Required Restrictions Description
credentialId string false The ID of the set of credentials to authenticate with the database.
credentials string false A list of credentials to use if this is a Spark dataset that requires credentials.
password string false The password (in cleartext) for database authentication. The password will be encrypted on the server-side HTTP request and never saved or stored. Required only if the previous data source was a data source. DEPRECATED: please use credentialId or credentialData instead.
useKerberos boolean false If true, use Kerberos for database authentication.
user string false The username for database authentication. Required only if the dataset was initially created from a data source. DEPRECATED: please use credentialId or credentialData instead.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

FullDatasetDetailsResponse

{
  "categories": [
    "BATCH_PREDICTIONS"
  ],
  "columnCount": 0,
  "createdBy": "string",
  "creationDate": "2019-08-24T14:15:22Z",
  "dataEngineQueryId": "string",
  "dataPersisted": true,
  "dataSourceId": "string",
  "dataSourceType": "string",
  "datasetId": "string",
  "datasetSize": 0,
  "description": "string",
  "eda1ModificationDate": "2019-08-24T14:15:22Z",
  "eda1ModifierFullName": "string",
  "entityCountByType": {
    "numCalendars": 0,
    "numExternalModelPackages": 0,
    "numFeatureDiscoveryConfigs": 0,
    "numPredictionDatasets": 0,
    "numProjects": 0,
    "numSparkSqlQueries": 0
  },
  "error": "string",
  "featureCount": 0,
  "featureCountByType": [
    {
      "count": 0,
      "featureType": "string"
    }
  ],
  "featureDiscoveryProjectId": "string",
  "isDataEngineEligible": true,
  "isLatestVersion": true,
  "isSnapshot": true,
  "isWranglingEligible": true,
  "lastModificationDate": "2019-08-24T14:15:22Z",
  "lastModifierFullName": "string",
  "name": "string",
  "processingState": "COMPLETED",
  "recipeId": "string",
  "rowCount": 0,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "tags": [
    "string"
  ],
  "timeSeriesProperties": {
    "isMostlyImputed": null
  },
  "uri": "string",
  "versionId": "string"
}

Properties

Name Type Required Restrictions Description
categories [string] true An array of strings describing the intended use of the dataset.
columnCount integer true The number of columns in the dataset.
createdBy string¦null true Username of the user who created the dataset.
creationDate string(date-time) true The date when the dataset was created.
dataEngineQueryId string¦null true ID of the source data engine query.
dataPersisted boolean true If true, user is allowed to view extended data profile (which includes data statistics like min/max/median/mean, histogram, etc.) and download data. If false, download is not allowed and only the data schema (feature names and types) will be available.
dataSourceId string¦null true ID of the datasource used as the source of the dataset.
dataSourceType string true The type of the datasource that was used as the source of the dataset.
datasetId string true The ID of this dataset.
datasetSize integer true The size of the dataset as a CSV in bytes.
description string¦null true The description of the dataset.
eda1ModificationDate string(date-time) true The ISO 8601 formatted date and time when the EDA1 for the dataset was updated.
eda1ModifierFullName string true The user who was the last to update EDA1 for the dataset.
entityCountByType EntityCountByTypeResponse false Number of different type entities that use the dataset.
error string true Details of exception raised during ingestion process, if any.
featureCount integer true Total number of features in the dataset.
featureCountByType [FeatureCountByTypeResponse] true Number of features in the dataset grouped by feature type.
featureDiscoveryProjectId string false Feature Discovery project ID used to create the dataset.
isDataEngineEligible boolean true Whether this dataset can be a data source of a data engine query.
isLatestVersion boolean true Whether this dataset version is the latest version of this dataset.
isSnapshot boolean true Whether the dataset is an immutable snapshot of data which has previously been retrieved and saved to DataRobot.
isWranglingEligible boolean true Whether the source of the dataset can support wrangling.
lastModificationDate string(date-time) true The ISO 8601 formatted date and time when the dataset was last modified.
lastModifierFullName string true Full name of user who was the last to modify the dataset.
name string true The name of this dataset in the catalog.
processingState string true Current ingestion process state of dataset.
recipeId string¦null true ID of the source recipe.
rowCount integer true The number of rows in the dataset.
sampleSize SampleSize false Ingest size to use during dataset registration. Default behavior is to ingest full dataset.
tags [string] true List of tags attached to the item.
timeSeriesProperties TimeSeriesProperties true Properties related to time series data prep.
uri string true The URI to datasource. For example, file_name.csv, or jdbc:DATA_SOURCE_GIVEN_NAME/SCHEMA.TABLE_NAME, or jdbc:DATA_SOURCE_GIVEN_NAME/<query> for query based datasources, orhttps://s3.amazonaws.com/datarobot_test/kickcars-sample-200.csv, etc.
versionId string true The object ID of the catalog_version the dataset belongs to.

Enumerated Values

Property Value
processingState [COMPLETED, ERROR, RUNNING]

GCPKey

{
  "authProviderX509CertUrl": "http://example.com",
  "authUri": "http://example.com",
  "clientEmail": "string",
  "clientId": "string",
  "clientX509CertUrl": "http://example.com",
  "privateKey": "string",
  "privateKeyId": "string",
  "projectId": "string",
  "tokenUri": "http://example.com",
  "type": "service_account"
}

The Google Cloud Platform (GCP) key. Output is the downloaded JSON resulting from creating a service account User Managed Key (in the IAM & admin > Service accounts section of GCP).Required if googleConfigId/configId is not specified.Cannot include this parameter if googleConfigId/configId is specified.

Properties

Name Type Required Restrictions Description
authProviderX509CertUrl string(uri) false Auth provider X509 certificate URL.
authUri string(uri) false Auth URI.
clientEmail string false Client email address.
clientId string false Client ID.
clientX509CertUrl string(uri) false Client X509 certificate URL.
privateKey string false Private key.
privateKeyId string false Private key ID
projectId string false Project ID.
tokenUri string(uri) false Token URI.
type string true GCP account type.

Enumerated Values

Property Value
type service_account

GeneratorSettings

{
  "datetimePartitionColumn": "string",
  "defaultCategoricalAggregationMethod": "last",
  "defaultNumericAggregationMethod": "mean",
  "defaultTextAggregationMethod": "concat",
  "endToSeriesMaxDatetime": true,
  "multiseriesIdColumns": [
    "string"
  ],
  "startFromSeriesMinDatetime": true,
  "target": "string",
  "timeStep": 0,
  "timeUnit": "DAY"
}

Data engine generator settings of the given generator_type.

Properties

Name Type Required Restrictions Description
datetimePartitionColumn string true The date column that will be used as a datetime partition column in time series project.
defaultCategoricalAggregationMethod string true Default aggregation method used for categorical feature.
defaultNumericAggregationMethod string true Default aggregation method used for numeric feature.
defaultTextAggregationMethod string false Default aggregation method used for text feature.
endToSeriesMaxDatetime boolean false A boolean value indicating whether generates post-aggregated series up to series maximum datetime or global maximum datetime.
multiseriesIdColumns [string] false maxItems: 1
minItems: 1
An array with the names of columns identifying the series to which row of the output dataset belongs. Currently, only one multiseries ID column is supported.
startFromSeriesMinDatetime boolean false A boolean value indicating whether post-aggregated series starts from series minimum datetime or global minimum datetime.
target string false The name of target for the output dataset.
timeStep integer true minimum: 0 (exclusive)
Number of time steps for the output dataset.
timeUnit string true Indicates which unit is a basis for time steps of the output dataset.

Enumerated Values

Property Value
defaultCategoricalAggregationMethod [last, mostFrequent]
defaultNumericAggregationMethod [mean, sum]
defaultTextAggregationMethod [concat, last, meanLength, mostFrequent, totalLength]
timeUnit [DAY, HOUR, MINUTE, MONTH, QUARTER, WEEK, YEAR]

GetDatasetVersionProjectsResponse

{
  "count": 0,
  "data": [
    {
      "id": "string",
      "url": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [DatasetProject] true Array of project references.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

GoogleServiceAccountCredentials

{
  "configId": "string",
  "credentialType": "gcp",
  "gcpKey": {
    "authProviderX509CertUrl": "http://example.com",
    "authUri": "http://example.com",
    "clientEmail": "string",
    "clientId": "string",
    "clientX509CertUrl": "http://example.com",
    "privateKey": "string",
    "privateKeyId": "string",
    "projectId": "string",
    "tokenUri": "http://example.com",
    "type": "service_account"
  },
  "googleConfigId": "string"
}

Properties

Name Type Required Restrictions Description
configId string false ID of Secure configurations shared by admin.Alternative to googleConfigId (deprecated). If specified, cannot include gcpKey.
credentialType string true The type of these credentials, 'gcp' here.
gcpKey GCPKey false The Google Cloud Platform (GCP) key. Output is the downloaded JSON resulting from creating a service account User Managed Key (in the IAM & admin > Service accounts section of GCP).Required if googleConfigId/configId is not specified.Cannot include this parameter if googleConfigId/configId is specified.
googleConfigId string false ID of Secure configurations shared by admin. This is deprecated.Please use configId instead. If specified, cannot include gcpKey.

Enumerated Values

Property Value
credentialType gcp

GrantAccessControlWithId

{
  "id": "string",
  "role": "string",
  "shareRecipientType": "user"
}

Properties

Name Type Required Restrictions Description
id string true The ID of the recipient.
role string true The role of the recipient on this entity. One of OWNER, USER, OBSERVER.
shareRecipientType string true Describes the recipient type, either user, group, or organization.

Enumerated Values

Property Value
shareRecipientType [user, group, organization]

GrantAccessControlWithUsername

{
  "role": "string",
  "shareRecipientType": "user",
  "username": "string"
}

Properties

Name Type Required Restrictions Description
role string true The role of the recipient on this entity. One of OWNER, USER, OBSERVER.
shareRecipientType string true Describes the recipient type, either user, group, or organization.
username string true Username of the user to update the access role for.

Enumerated Values

Property Value
shareRecipientType [user, group, organization]

Hdfs

{
  "categories": "BATCH_PREDICTIONS",
  "doSnapshot": true,
  "namenodeWebhdfsPort": 0,
  "password": "string",
  "persistDataAfterIngestion": true,
  "url": "http://example.com",
  "user": "string"
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
doSnapshot boolean false If true, create a snapshot dataset; if false, create a remote dataset. Creating snapshots from non-file sources requires an additional permission, Enable Create Snapshot Data Source.
namenodeWebhdfsPort integer false The port of HDFS name node.
password string false The password (in cleartext) for authenticating to HDFS using Kerberos. The password will be encrypted on the server side in scope of HTTP request and never saved or stored.
persistDataAfterIngestion boolean false If true, will enforce saving all data (for download and sampling) and will allow a user to view extended data profile (which includes data statistics like min/max/median/mean, histogram, etc.). If false, will not enforce saving data. The data schema (feature names and types) still will be available. Specifying this parameter to false and doSnapshot to true will result in an error
url string(uri) true The HDFS url to use as the source of data for the dataset being created.
user string false The username for authenticating to HDFS using Kerberos.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

MaterializationDestination

{
  "catalog": "string",
  "schema": "string",
  "table": "string"
}

Destination table information to create and materialize the recipe to. If None, the recipe will be materialized in DataRobot.

Properties

Name Type Required Restrictions Description
catalog string true Database to materialize the recipe to.
schema string true Schema to materialize the recipe to.
table string true Table name to create and materialize the recipe to. This table should not already exist.

OAuthCredentials

{
  "credentialType": "oauth",
  "oauthAccessToken": null,
  "oauthClientId": null,
  "oauthClientSecret": null,
  "oauthRefreshToken": "string"
}

Properties

Name Type Required Restrictions Description
credentialType string true The type of these credentials, 'oauth' here.
oauthAccessToken string¦null false The oauth access token.
oauthClientId string¦null false The oauth client ID.
oauthClientSecret string¦null false The oauth client secret.
oauthRefreshToken string true The oauth refresh token.

Enumerated Values

Property Value
credentialType oauth

ParamValuePair

{
  "param": "string",
  "value": "string"
}

Properties

Name Type Required Restrictions Description
param string true The name of a field associated with the value.
value any true Any value.

oneOf

Name Type Required Restrictions Description
» anonymous any false none

anyOf

Name Type Required Restrictions Description
»» anonymous string false none

or

Name Type Required Restrictions Description
»» anonymous integer false none

or

Name Type Required Restrictions Description
»» anonymous boolean false none

or

Name Type Required Restrictions Description
»» anonymous number false none

xor

Name Type Required Restrictions Description
» anonymous [anyOf] false none

anyOf

Name Type Required Restrictions Description
»» anonymous string false none

or

Name Type Required Restrictions Description
»» anonymous integer false none

or

Name Type Required Restrictions Description
»» anonymous boolean false none

or

Name Type Required Restrictions Description
»» anonymous number false none

PatchDataset

{
  "categories": "BATCH_PREDICTIONS",
  "name": "string"
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset. If any categories were previously specified for the dataset, they will be overwritten.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
name string false The new name of the dataset.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

RetrieveDataEngineQueryResponse

{
  "datasets": [
    {
      "alias": "string",
      "datasetId": "string",
      "datasetVersionId": "string"
    }
  ],
  "generatorSettings": {
    "datetimePartitionColumn": "string",
    "defaultCategoricalAggregationMethod": "last",
    "defaultNumericAggregationMethod": "mean",
    "defaultTextAggregationMethod": "concat",
    "endToSeriesMaxDatetime": true,
    "multiseriesIdColumns": [
      "string"
    ],
    "startFromSeriesMinDatetime": true,
    "target": "string",
    "timeStep": 0,
    "timeUnit": "DAY"
  },
  "generatorType": "TimeSeries",
  "id": "string",
  "query": "string"
}

Properties

Name Type Required Restrictions Description
datasets [DataEngineDataset] true maxItems: 32
Source datasets in the Data Engine workspace.
generatorSettings GeneratorSettings true Data engine generator settings of the given generator_type.
generatorType string true Type of data engine query generator
id string true The ID of the data engine query generator.
query string true Generated SparkSQL query.

Enumerated Values

Property Value
generatorType TimeSeries

S3Credentials

{
  "awsAccessKeyId": "string",
  "awsSecretAccessKey": "string",
  "awsSessionToken": null,
  "configId": "string",
  "credentialType": "s3"
}

Properties

Name Type Required Restrictions Description
awsAccessKeyId string false The S3 AWS access key ID. Required if configId is not specified.Cannot include this parameter if configId is specified.
awsSecretAccessKey string false The S3 AWS secret access key. Required if configId is not specified.Cannot include this parameter if configId is specified.
awsSessionToken string¦null false The S3 AWS session token for AWS temporary credentials.Cannot include this parameter if configId is specified.
configId string false ID of Secure configurations of credentials shared by admin.If specified, cannot include awsAccessKeyId, awsSecretAccessKey or awsSessionToken
credentialType string true The type of these credentials, 's3' here.

Enumerated Values

Property Value
credentialType s3

SampleSize

{
  "type": "rows",
  "value": 0
}

Ingest size to use during dataset registration. Default behavior is to ingest full dataset.

Properties

Name Type Required Restrictions Description
type string true Sample size can be specified only as a number of rows for now.
value integer true maximum: 1000000
minimum: 0 (exclusive)
Number of rows to ingest during dataset registration.

Enumerated Values

Property Value
type rows

SharedRolesListResponse

{
  "count": 0,
  "data": [
    {
      "canShare": true,
      "canUseData": true,
      "id": "string",
      "name": "string",
      "role": "CONSUMER",
      "shareRecipientType": "user",
      "userFullName": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [SharedRolesResponse] true An array of SharedRoles objects.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

SharedRolesResponse

{
  "canShare": true,
  "canUseData": true,
  "id": "string",
  "name": "string",
  "role": "CONSUMER",
  "shareRecipientType": "user",
  "userFullName": "string"
}

Properties

Name Type Required Restrictions Description
canShare boolean true True if this user can share with other users
canUseData boolean true True if the user can view, download and process data (use to create projects, predictions, etc)
id string true The ID of the recipient organization, group or user.
name string true The name of the recipient organization, group or user.
role string true The role of the org/group/user on this dataset or "NO_ROLE" for removing access when used with route to modify access.
shareRecipientType string true It describes the recipient type.
userFullName string false If the recipient type is a user, the full name of the user if available.

Enumerated Values

Property Value
role [CONSUMER, EDITOR, OWNER, NO_ROLE]
shareRecipientType [user, group, organization]

SharedRolesUpdate

{
  "operation": "updateRoles",
  "roles": [
    {
      "role": "string",
      "shareRecipientType": "user",
      "username": "string"
    }
  ]
}

Properties

Name Type Required Restrictions Description
operation string true Name of the action being taken. The only operation is 'updateRoles'.
roles [oneOf] true maxItems: 100
minItems: 1
Array of GrantAccessControl objects., up to maximum 100 objects.

oneOf

Name Type Required Restrictions Description
» anonymous GrantAccessControlWithUsername false none

xor

Name Type Required Restrictions Description
» anonymous GrantAccessControlWithId false none

Enumerated Values

Property Value
operation updateRoles

SnowflakeKeyPairCredentials

{
  "configId": "string",
  "credentialType": "snowflake_key_pair_user_account",
  "passphrase": "string",
  "privateKeyStr": "string",
  "user": "string"
}

Properties

Name Type Required Restrictions Description
configId string false The ID of the saved shared credentials. If specified, cannot include user, privateKeyStr or passphrase.
credentialType string true The type of these credentials, 'snowflake_key_pair_user_account' here.
passphrase string false Optional passphrase to decrypt private key. Cannot include this parameter if configId is specified.
privateKeyStr string false Private key for key pair authentication. Required if configId is not specified. Cannot include this parameter if configId is specified.
user string false Username for this credential. Required if configId is not specified. Cannot include this parameter if configId is specified.

Enumerated Values

Property Value
credentialType snowflake_key_pair_user_account

TimeSeriesProperties

{
  "isMostlyImputed": null
}

Properties related to time series data prep.

Properties

Name Type Required Restrictions Description
isMostlyImputed boolean¦null true Whether more than half of the rows are imputed.

UpdateCatalogMetadata

{
  "description": "string",
  "name": "string",
  "tags": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
description string false maxLength: 1000
New catalog item description
name string false maxLength: 255
New catalog item name
tags [string] false New catalog item tags. Tags must be the lower case, without spaces,and cannot include -$.,{}"#' special characters.

UpdateDatasetDeleted

{}

Properties

None

Url

{
  "categories": "BATCH_PREDICTIONS",
  "doSnapshot": true,
  "persistDataAfterIngestion": true,
  "sampleSize": {
    "type": "rows",
    "value": 0
  },
  "url": "string"
}

Properties

Name Type Required Restrictions Description
categories any false An array of strings describing the intended use of the dataset.

oneOf

Name Type Required Restrictions Description
» anonymous string false none

xor

Name Type Required Restrictions Description
» anonymous [string] false none

continued

Name Type Required Restrictions Description
doSnapshot boolean false If true, create a snapshot dataset; if false, create a remote dataset. Creating snapshots from non-file sources requires an additional permission, Enable Create Snapshot Data Source.
persistDataAfterIngestion boolean false If true, will enforce saving all data (for download and sampling) and will allow a user to view extended data profile (which includes data statistics like min/max/median/mean, histogram, etc.). If false, will not enforce saving data. The data schema (feature names and types) still will be available. Specifying this parameter to false and doSnapshot to true will result in an error.
sampleSize SampleSize false Ingest size to use during dataset registration. Default behavior is to ingest full dataset.
url string(url) true The URL to download the dataset used to create the dataset item and version.

Enumerated Values

Property Value
anonymous [BATCH_PREDICTIONS, MULTI_SERIES_CALENDAR, PREDICTION, SINGLE_SERIES_CALENDAR, TRAINING]

UserBlueprintAddToMenu

{
  "deleteAfter": false,
  "describeFailures": false,
  "projectId": "string",
  "userBlueprintIds": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
deleteAfter boolean true Whether to delete the user blueprint(s) after adding it (them) to the project menu.
describeFailures boolean true Whether to include extra fields to describe why any blueprints were not added to the chosen project.
projectId string true The projectId of the project for the repository to add the specified user blueprints to.
userBlueprintIds [string] true The ids of the user blueprints to add to the specified project's repository.

UserBlueprintAddToMenuResponse

{
  "addedToMenu": [
    {
      "blueprintId": "string",
      "userBlueprintId": "string"
    }
  ],
  "message": "string",
  "notAddedToMenu": [
    {
      "error": "string",
      "userBlueprintId": "string"
    }
  ]
}

Properties

Name Type Required Restrictions Description
addedToMenu [UserBlueprintAddedToMenuItem] true The list of userBlueprintId and blueprintId pairs representing blueprints successfully added to the project repository.
message string false A success message or a list of reasons why the list of blueprints could not be added to the project repository.
notAddedToMenu [UserBlueprintFailedToAddToMenuItem] false The list of userBlueprintId and error message representing blueprints which failed to be added to the project repository.

UserBlueprintAddedToMenuItem

{
  "blueprintId": "string",
  "userBlueprintId": "string"
}

Properties

Name Type Required Restrictions Description
blueprintId string true The blueprintId representing the blueprint which was added to the project repository.
userBlueprintId string true The userBlueprintId associated with the blueprintId added to the project repository.

UserBlueprintBulkValidationRequest

{
  "projectId": "string",
  "userBlueprintIds": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
projectId string false String representation of ObjectId for the currently active project. The user blueprint is validated when this project is active. Necessary in the event of project specific tasks, such as column selection tasks.
userBlueprintIds [string] true The ids of the user blueprints to validate in bulk.

UserBlueprintCreate

{
  "blueprint": [
    {
      "taskData": {
        "inputs": [
          "string"
        ],
        "outputMethod": "string",
        "outputMethodParameters": [],
        "taskCode": "string",
        "taskParameters": [],
        "xTransformations": [],
        "yTransformations": []
      },
      "taskId": "string"
    }
  ],
  "decompressedBlueprint": false,
  "description": "string",
  "getDynamicLabels": false,
  "isInplaceEditor": false,
  "modelType": "string",
  "projectId": "string",
  "saveToCatalog": true
}

Properties

Name Type Required Restrictions Description
blueprint any true The representation of a directed acyclic graph defining a pipeline of data through tasks and a final estimator.

oneOf

Name Type Required Restrictions Description
» anonymous [UserBlueprintsBlueprintTask] false The representation of a directed acyclic graph defining a pipeline of data through tasks and a final estimator.

xor

Name Type Required Restrictions Description
» anonymous AllowExtra false Parameters submitted by the user to the failed job

continued

Name Type Required Restrictions Description
decompressedBlueprint boolean true Whether to retrieve the blueprint in the decompressed format.
description string false The description to give to the blueprint.
getDynamicLabels boolean false Whether to add dynamic labels to a decompressed blueprint.
isInplaceEditor boolean true Whether the request is sent from the in place user BP editor.
modelType string false The title to give to the blueprint.
projectId string¦null false String representation of ObjectId for the currently active project. The user blueprint is created when this project is active. Necessary in the event of project specific tasks, such as column selection tasks.
saveToCatalog boolean true Whether to save the blueprint to the catalog.

UserBlueprintCreateFromBlueprintId

{
  "blueprintId": "string",
  "decompressedBlueprint": false,
  "description": "string",
  "getDynamicLabels": false,
  "isInplaceEditor": false,
  "modelType": "string",
  "projectId": "string",
  "saveToCatalog": true
}

Properties

Name Type Required Restrictions Description
blueprintId string true The id associated with the blueprint to create the user blueprint from.
decompressedBlueprint boolean true Whether to retrieve the blueprint in the decompressed format.
description string false The description to give to the blueprint.
getDynamicLabels boolean false Whether to add dynamic labels to a decompressed blueprint.
isInplaceEditor boolean true Whether the request is sent from the in place user BP editor.
modelType string false The title to give to the blueprint.
projectId string true String representation of ObjectId for the currently active project. The user blueprint is created when this project is active.
saveToCatalog boolean true Whether to save the blueprint to the catalog.

UserBlueprintCreateFromCustomTaskVersionIdPayload

{
  "customTaskVersionId": "string",
  "decompressedBlueprint": false,
  "description": "string",
  "saveToCatalog": true
}

Properties

Name Type Required Restrictions Description
customTaskVersionId string true The ID of a custom task version.
decompressedBlueprint boolean true Whether to retrieve the blueprint in the decompressed format.
description string false The description for the user blueprint that will be created from this CustomTaskVersion.
saveToCatalog boolean true Whether to save the blueprint to the catalog.

UserBlueprintCreateFromUserBlueprintId

{
  "decompressedBlueprint": false,
  "description": "string",
  "getDynamicLabels": false,
  "isInplaceEditor": false,
  "modelType": "string",
  "projectId": "string",
  "saveToCatalog": true,
  "userBlueprintId": "string"
}

Properties

Name Type Required Restrictions Description
decompressedBlueprint boolean true Whether to retrieve the blueprint in the decompressed format.
description string false The description to give to the blueprint.
getDynamicLabels boolean false Whether to add dynamic labels to a decompressed blueprint.
isInplaceEditor boolean true Whether the request is sent from the in place user BP editor.
modelType string false The title to give to the blueprint.
projectId string¦null false String representation of ObjectId for the currently active project. The user blueprint is created when this project is active. Necessary in the event of project specific tasks, such as column selection tasks.
saveToCatalog boolean true Whether to save the blueprint to the catalog.
userBlueprintId string true The id of the existing user blueprint to copy.

UserBlueprintFailedToAddToMenuItem

{
  "error": "string",
  "userBlueprintId": "string"
}

Properties

Name Type Required Restrictions Description
error string true The error message representing why the blueprint was not added to the project repository.
userBlueprintId string true The userBlueprintId associated with the blueprint which was not added to the project repository.

UserBlueprintSharedRolesListResponse

{
  "count": 0,
  "data": [
    {
      "id": "string",
      "name": "string",
      "role": "CONSUMER",
      "shareRecipientType": "user"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [UserBlueprintSharedRolesResponse] true A list of SharedRoles objects.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

UserBlueprintSharedRolesResponse

{
  "id": "string",
  "name": "string",
  "role": "CONSUMER",
  "shareRecipientType": "user"
}

Properties

Name Type Required Restrictions Description
id string true The ID of the recipient organization, group or user.
name string true The name of the recipient organization, group or user.
role string true The role of the org/group/user on this dataset or "NO_ROLE" for removing access when used with route to modify access.
shareRecipientType string true Describes the recipient type, either user, group, or organization.

Enumerated Values

Property Value
role [CONSUMER, EDITOR, OWNER]
shareRecipientType [user, group, organization]

UserBlueprintTask

{
  "arguments": [
    {
      "argument": {
        "default": "string",
        "name": "string",
        "recommended": "string",
        "tunable": true,
        "type": "string",
        "values": "string"
      },
      "key": "string"
    }
  ],
  "categories": [
    "string"
  ],
  "colnamesAndTypes": [
    {
      "colname": "string",
      "hex": "string",
      "type": "string"
    }
  ],
  "customTaskId": "string",
  "customTaskVersions": [
    {
      "id": "string",
      "label": "string",
      "versionMajor": 0,
      "versionMinor": 0
    }
  ],
  "description": "string",
  "icon": 0,
  "isCommonTask": false,
  "isCustomTask": true,
  "isVisibleInComposableMl": true,
  "label": "string",
  "outputMethods": [
    "string"
  ],
  "supportsScoringCode": true,
  "taskCode": "string",
  "timeSeriesOnly": true,
  "url": {},
  "validInputs": [
    "string"
  ]
}

Properties

Name Type Required Restrictions Description
arguments [UserBlueprintTaskArgument] true A list of definitions of each argument which can be set for the task.
categories [string] true The categories which the task is in.
colnamesAndTypes [ColnameAndType]¦null false The column names, their types, and their hex representation, available in the specified project for the task.
customTaskId string¦null false The id of the custom task, if it is a custom task.
customTaskVersions [UserBlueprintTaskCustomTaskMetadataWithArguments]¦null false Metadata for all of the custom task's versions.
description string true A description of the task.
icon integer true The integer representing the id to be displayed when the blueprint is trained.
isCommonTask boolean false Whether the task is a common task.
isCustomTask boolean false Whether the task is custom code written by the user.
isVisibleInComposableMl boolean false Whether the task is visible in the ComposableML menu
label string true The generic / default title or label for the task.
outputMethods [string] true The methods which the task can use to produce output.
supportsScoringCode boolean true Whether the task supports Scoring Code.
taskCode string true The unique code which represents the task to be constructed and executed
timeSeriesOnly boolean true Whether the task can only be used with time series projects.
url any true The URL of the documentation of the task.

oneOf

Name Type Required Restrictions Description
» anonymous AllowExtra false Parameters submitted by the user to the failed job

xor

Name Type Required Restrictions Description
» anonymous string false none

continued

Name Type Required Restrictions Description
validInputs [string] true The supported input types of the task.

UserBlueprintTaskArgument

{
  "argument": {
    "default": "string",
    "name": "string",
    "recommended": "string",
    "tunable": true,
    "type": "string",
    "values": "string"
  },
  "key": "string"
}

Properties

Name Type Required Restrictions Description
argument UserBlueprintTaskArgumentDefinition true The definition of a task argument, used to specify a certain aspect of the task.
key string true The unique key of the argument

UserBlueprintTaskArgumentDefinition

{
  "default": "string",
  "name": "string",
  "recommended": "string"</