# REST API changelogs
URL: https://docs.datarobot.com/en/docs/api/reference/changelogs/rest-changelog/index.html

> Reference the changes introduced to new versions of DataRobot's REST API.

# REST API changelogs

Changelogs contain curated, ordered lists of notable changes for each versioned release for [DataRobot's REST API client](https://docs.datarobot.com/en/docs/api/reference/public-api/index.html). Reference the changelog below to view changes for DataRobot's newest version, and view previous versions in the table of contents.

## v2.43 changelog

Reference for the changes introduced to version 2.43 of DataRobot's REST API.

### New features

- Added new endpoints for the REST API:

## v2.42 changelog

Reference for the changes introduced to version 2.42 of DataRobot's REST API.

### New features

- Added new endpoints for general API usage:
- Added an endpoint for limits on deployments:GET /api/v2/deployments/limits/
- Added new endpoints for File Management. Use the endpoints for file uploads, downloads, and management. The feature is comprised of the following endpoints:
- Added an endpoint for insights & analytics:POST /api/v2/insights/confusionMatrix/
- Added an endpoint for confusion matrices:GET /api/v2/insights/confusionMatrix/models/{entityId}/

### API changes

- ParameterintakeTypeschema updated forGET /api/v2/batchJobs/.
- ParameterintakeTypeschema updated forGET /api/v2/batchPredictions/.
- ParameterhardDeleteschema updated forDELETE /api/v2/customApplicationSources/{appSourceId}/.
- ParameterhardDeleteschema updated forDELETE /api/v2/customApplications/{applicationId}/.
- Parameterreplicasschema updated forGET /api/v2/customModelTests/.
- Description updated forGET /api/v2/customTasks/.
- Description updated forPOST /api/v2/customTasks/.
- Parametereventschema updated forGET /api/v2/eventLogs/.
- Parameteridsschema updated forGET /api/v2/externalOAuth/providers/.
- Removed parameterskip_consent(query) forPOST /api/v2/externalOAuth/providers/{providerId}/authorize/.
- ParameteruseCasesschema updated forGET /api/v2/mlops/compute/bundles/.
- Description updated forPOST /api/v2/deployments/fromLearningModel/.
- Removed parameterhardDelete(query) forDELETE /api/v2/executionEnvironments/{environmentId}/.
- Description updated forGET /api/v2/tenantUsageResources/.
- Description updated forGET /api/v2/tenantUsageResources/activeUsers/.
- Description updated forGET /api/v2/tenantUsageResources/categories/.
- Description updated forGET /api/v2/tenantUsageResources/export/.
- Description updated forGET /api/v2/tenants/{tenantId}/resourceCategories/.
- ParameterbinarySortMetricschema updated forGET /api/v2/useCases/{useCaseId}/modelsForComparison/.

### Deprecation summary

- The API endpoint POST /api/v2/externalOAuth/authorizedProviders/{authorizedProviderId}/accessToken/ is deprecated.

## v2.41 changelog

Reference for the changes introduced to version 2.41  of DataRobot's REST API.

### New features

- Added an endpoint for user invitations: POST /api/v2/users/invite/

### API changes

- Parameter 'types' schema updated forGET /api/v2/credentials/.
- Parameter 'types' schema updated forGET /api/v2/credentials/{credentialId}/associations/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/entityNotificationChannels/{relatedEntityType}/{relatedEntityId}/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/entityNotificationChannels/{relatedEntityType}/{relatedEntityId}/{channelId}/.
- Parameter 'relatedEntityType' schema updated forPUT /api/v2/entityNotificationChannels/{relatedEntityType}/{relatedEntityId}/{channelId}/.
- Parameter 'relatedEntityType' schema updated forDELETE /api/v2/entityNotificationChannels/{relatedEntityType}/{relatedEntityId}/{channelId}/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/entityNotificationPolicies/{relatedEntityType}/{relatedEntityId}/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/entityNotificationPolicies/{relatedEntityType}/{relatedEntityId}/{policyId}/.
- Parameter 'relatedEntityType' schema updated forPUT /api/v2/entityNotificationPolicies/{relatedEntityType}/{relatedEntityId}/{policyId}/.
- Parameter 'relatedEntityType' schema updated forDELETE /api/v2/entityNotificationPolicies/{relatedEntityType}/{relatedEntityId}/{policyId}/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/{policyId}/.
- Parameter 'relatedEntityType' schema updated forPUT /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/{policyId}/.
- Parameter 'relatedEntityType' schema updated forDELETE /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/{policyId}/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/{policyId}/relatedPolicies/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/{policyId}/sharedRoles/.
- Parameter 'relatedEntityType' schema updated forPATCH /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/{policyId}/sharedRoles/.
- Parameter 'event' schema updated forGET /api/v2/eventLogs/.
- Parameter 'types' schema updated forPOST /api/v2/externalDataStores/{dataStoreId}/columnsInfo/.
- Parameter 'types' schema updated forGET /api/v2/externalDataStores/{dataStoreId}/credentials/.
- The new optional parameterprefixhas been added toGET /api/v2/files/{catalogId}/allFiles/.
- The new optional parameterprefixhas been added toGET /api/v2/files/{catalogId}/versions/{catalogVersionId}/allFiles/.
- Description updated forPOST /api/v2/notificationChannelTemplates/.
- Parameter 'relatedEntityType' schema updated forGET /api/v2/notificationEvents/.
- Parameter 'startTime' description updated forGET /api/v2/otel/{entityType}/{entityId}/logs/.
- Parameter 'startTime' description updated forGET /api/v2/otel/{entityType}/{entityId}/metrics/autocollectedValues/.
- Parameter 'startTime' description updated forGET /api/v2/otel/{entityType}/{entityId}/metrics/podInfo/.
- Parameter 'segmentValue' description updated forGET /api/v2/otel/{entityType}/{entityId}/metrics/values/segments/{segmentAttribute}/.
- Response 403 description updated forPOST /api/v2/otel/{entityType}/{entityId}/metrics/valuesOverTime/segments/.
- Parameter 'segmentValue' description updated forGET /api/v2/otel/{entityType}/{entityId}/metrics/valuesOverTime/segments/{segmentAttribute}/.
- Parameter 'startTime' description updated forGET /api/v2/otel/{entityType}/{entityId}/traces/.
- Parameter 'traceId' description updated forGET /api/v2/otel/{entityType}/{entityId}/traces/{traceId}/.
- The new optional parametertagFiltershas been added toGET /api/v2/registeredModels/.
- Parameter 'startTime' description updated forGET /api/v2/tracing/{entityType}/{entityId}/.
- Parameter 'traceId' description updated forGET /api/v2/tracing/{entityType}/{entityId}/{traceId}/.

## v2.40 changelog

Reference for the changes introduced to version 2.40 of DataRobot's REST API.

### New features

- Added an endpoint for deployment quota tracking:GET /api/v2/deployments/{deploymentId}/quotaConsumers/
- Added an endpoint for execution environment build management:PATCH /api/v2/executionEnvironments/{environmentId}/versions/{environmentVersionId}/cancelBuild/
- Added new endpoints for OpenTelemetry Metrics Segmentation. Retrieve OpenTelemetry metrics grouped by specific segment attributes for detailed analysis of metric values across different dimensions. This functionality enables users to analyze metrics by custom attributes such as deployment, model version, or other entity characteristics, both for single time periods and over time. Helps identify patterns, anomalies, and performance differences across different segments of operations, enabling more granular observability and troubleshooting. The feature is comprised of the following endpoints:
- GET /api/v2/otel/{entityType}/{entityId}/metrics/values/segments/{segmentAttribute}/
- GET /api/v2/otel/{entityType}/{entityId}/metrics/valuesOverTime/segments/{segmentAttribute}/
- Added new endpoints for Tenant Usage and Resource Utilization. Monitor tenant activity and CPU/GPU resource utilization across the platform for administrative oversight and capacity planning. This functionality enables administrators to track active tenants, view aggregated CPU and GPU resource utilization by resource type, and export utilization data for reporting and analysis. Helps administrators understand platform-wide resource consumption, identify tenants with high utilization, plan capacity upgrades, and optimize resource allocation across the organization.. The feature is comprised of the following endpoints:
- GET /api/v2/tenantUsageResources/activeTenants/
- GET /api/v2/tenants/utilizationResources/
- GET /api/v2/tenants/utilizationResources/export/
- GET /api/v2/tenants/utilizationResources/{resourceType}/

### API changes

- Parameter 'templateType' schema was updated forGET /api/v2/codeSnippets/.
- Parameter 'eventGroup' schema was updated forGET /api/v2/entityNotificationPolicies/{relatedEntityType}/{relatedEntityId}/.
- Parameter 'eventGroup' schema was updated forGET /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/.
- Parameter 'eventGroup' schema was updated forGET /api/v2/notificationPolicies/.
- The new optional parameterinvitedhas been added toGET /api/v2/users/.

## v2.39 changelog

Reference for the changes introduced to version 2.39 of DataRobot's REST API.

### New features

- Added an endpoint for custom metrics bulk upload:POST /api/v2/deployments/{deploymentId}/customMetrics/bulkUpload/
- Added new endpoints for prompt template management to manage LLMs and prompt templates for generative AI workflows. This functionality enables users to retrieve LLM information, create and manage prompt templates with versioning support, and organize prompts for consistent use across generative AI applications. Prompt templates can be versioned to track changes over time and maintain reproducibility. The endpoints support the full lifecycle of prompt management from creation to version tracking, enabling you to develop, test, and deploy prompts systematically.
- Added new endpoints for OpenTelemetry metrics observability. Retrieve OpenTelemetry metrics data to monitor and observe DataRobot entities. This functionality provides access to automatically collected metrics, pod and container information, and metric values over time grouped by attributes. The endpoints enable users to monitor system performance, resource utilization, and application health through standardized OpenTelemetry metrics. They also help troubleshoot performance issues and understand resource consumption patterns across deployments and other entities.
- Added new endpoints for Tenant Usage and Resource Management. Use the endpoints to monitor and export tenant resource usage and active user information for administrative oversight and capacity planning. This functionality enables system and organization administrators to track resource consumption across tenants, identify active users, retrieve available resource categories, and export usage data for reporting and analysis. The endpoints support both tenant-specific and cluster-wide usage reporting, helping administrators understand platform utilization, plan capacity, and ensure efficient resource allocation.

### API changes

- ParameterentityTypeschema updated forGET /api/v2/comments/{entityType}/{entityId}/.
- ParametereventGroupschema updated forGET /api/v2/entityNotificationPolicies/{relatedEntityType}/{relatedEntityId}/.
- ParametereventGroupschema updated forGET /api/v2/entityNotificationPolicyTemplates/{relatedEntityType}/.
- ParametereventGroupschema updated forGET /api/v2/notificationPolicies/.
- The new optional parameterskip_consenthas been added toPOST /api/v2/externalOAuth/providers/{providerId}/authorize/.
- Parameterlimitschema updated forGET /api/v2/genai/llms/.
- The new optional parameterspanIdhas been added toGET /api/v2/otel/{entityType}/{entityId}/logs/.
- Description updated forGET /api/v2/tenants/{tenantId}/activeUsers/.
- Removed parametertenantId(path) forGET /api/v2/tenants/{tenantId}/resourceCategories/.
- Description updated forGET /api/v2/tenants/{tenantId}/usage/.
- Description updated forGET /api/v2/tenants/{tenantId}/usageExport/.

## v2.38 changelog

### Deprecation summary

- Deprecated thecustomJobIdfield within the trigger property fromPOST /api/v2/deployments/(deploymentId)/retrainingPolicies/andPATCH /api/v2/deployments/(deploymentId)/retrainingPolicies/(retrainingPolicyId)/. This field will be removed in v2.40.
- Thecustom_jobtrigger type is no longer supported forPOST /api/v2/deployments/(deploymentId)/retrainingPolicies/andPATCH /api/v2/deployments/(deploymentId)/retrainingPolicies/(retrainingPolicyId)/. To create a custom job retraining policy, usemodel_selection: custom_jobinstead.  The option is no longer documented and will be removed in v2.40.

## v2.37 changelog

v2.37 of the DataRobot REST API introduced no reported changes.

## v2.36 changelog

### New features

- Added new endpoints for role based access management. Uses the following endpoints:
- GET /api/v2/accessRoles/
- GET /api/v2/accessRoles/{role_id}/
- POST /api/v2/accessRoles/
- PUT /api/v2/accessRoles/{role_id}/
- DELETE /api/v2/accessRoles/{role_id}/
- GET /api/v2/accessRoles/users/
- Added an endpoint that initializes the incremental learning model and begins training using the chunking servicePOST /api/v2/projects/(projectId)/incrementalLearningModels/fromSampleModel/. To use it, enable the feature flag "Sample Data to Start Project."
- Added an endpoint for retrieving themodel_historyof a deploymentGET /api/v2/deployments/(deploymentId)/modelHistory/.
- Added new APIs for secure configuration management. Uses the following endpoints:
- POST /api/v2/secureConfigs/
- GET /api/v2/secureConfigSchemas/
- GET /api/v2/secureConfigSchemas/(secureConfigSchemaId)/
- PATCH /api/v2/secureConfigs/(secureConfigId)/
- GET /api/v2/secureConfigs/(secureConfigId)/values/
- GET /api/v2/secureConfigs/(secureConfigId)/sharedRoles/
- PATCH /api/v2/secureConfigs/(secureConfigId)/sharedRoles/
- The start and end query parameters are no longer required for GET /api/v2/deployments/(deploymentId)/dataQualityView/ . Defaults will be provided for a one week span when not specified.
- The start and end body parameters are no longer required for POST /api/v2/deployments/{deploymentId}/predictionDataExports/ . Defaults will be provided for a one week span when not specified.

### Deprecation summary

- Removed the field capabilities from GET /api/v2/deployments/ and GET /api/v2/deployments/(deploymentId)/ , after being deprecated in 2.29. Instead, use GET /api/v2/deployments/(deploymentId)/capabilities/ .
- Removed the query param targetClasses from GET /api/v2/deployments/(deploymentId)/accuracy/ and GET /api/v2/deployments/(deploymentId)/accuracyOverTime/ , after being deprecated in 2.31. Instead, use targetClass query param.
- Deprecated metrics and modelId fields from GET /api/v2/deployments/(deploymentId)/accuracy/ , use data field in the same endpoint instead. The deprecated fields will be removed in 2.40.

## v2.35 changelog

Reference the changes introduced to version 2.35 of DataRobot's REST API.

### New features

- Added new endpoints for OCR Jobs. This is a feature for processing datasets with PDFs. It runs OCR on the PDFs in the dataset and replaces all images in those PDFs with text. The feature is comprised of the following endpoints:

### API changes

- The new optional parameternumberOfIncrementalLearningIterationsBeforeBestModelSelectionfor projects with the auto-incremental learning option has been added toPATCH /api/v2/projects/(projectId)/aim/. It is used in automated incremental learning Autopilot mode.
- Added endpoints to calculate and retrieve the SHAP distributions data:
- POST /api/v2/insights/shapDistributions/
- GET /api/v2/insights/shapDistributions/models/(entityId)/

### Deprecation summary

- The API endpoint GET /api/v2/projects/(projectId)/models/(modelId)/primeInfo/ is deprecated, as creating Prime models is no longer supported.
- The query params projectId and applicationId have been deprecated for GET /api/v2/useCases/ .

### Documentation changes

- The correct expected HTTP response code has been documented for POST /api/v2/notifications/ . It should return a 201 , but 200 was previously documented.
- The correct expected HTTP response code has been documented for PATCH /api/v2/ssoConfigurations/(configurationId)/ . It should return a 204 , but 200 was previously documented.
 in June 2025.

## v2.34 changelog

Reference the changes introduced to version 2.34 of DataRobot's REST API.

### New features

- Added an endpoint to create a hosted custom metric from a custom job: POST /api/v2/deployments/(deploymentId)/customMetrics/fromCustomJob/ .
- Added an endpoint to list hosted custom metrics: GET /api/v2/customJobs/(customJobId)/customMetrics/ .
- Added an endpoint to update the hosted custom metric PATCH /api/v2/deployments/(deploymentId)/customMetrics/(customMetricId)/ .
- Added an endpoint to delete the hosted custom metric DELETE /api/v2/deployments/(deploymentId)/customMetrics/(customMetricId)/ .
- Added an endpoint to create custom job from hosted custom metrics gallery template POST /api/v2/customJobs/fromHostedCustomMetricGalleryTemplate/ .
- Added an endpoint to create a blueprint for the hosted custom metric POST /api/v2/customJobs/(customJobId)/hostedCustomMetricTemplate/ .
- Added an endpoint to retrieve a blueprint for the hosted custom metric GET /api/v2/customJobs/(customJobId)/hostedCustomMetricTemplate/ .
- Added an endpoint to update a blueprint for the hosted custom metric GET /api/v2/customJobs/(customJobId)/hostedCustomMetricTemplate/ .

### Enhancements

- Requests for insights at the/api/v2/insights/*group of endpoints now accept theentityTypeparameter, which enables insight computation forcustomModelentities as well as nativedatarobotModelentities. To compute insights on a custom model, you must first initialize insights with a call toPOST /api/v2/modelComplianceDocsInitializations/(entityId)/.
- The response from the Get SHAP impact API endpointGET /api/v2/insights/shapImpact/models/(entityId)/has been changed. Now theshapImpactsparameter is a list of key-pair values. Thecappingparameter has been removed from the response.

### Deprecation summary

- The API endpoint GET /api/v2/projects/(projectId)/models/ is deprecated. Instead, use GET /api/v2/projects/(projectId)/modelRecords/ .
- The API endpoint /projects/(projectId)/featureAssocationFeaturelists/ is removed, after being deprecated in release 2.19. Users should continue to use GET /api/v2/projects/(projectId)/featureAssociationFeaturelists/ .
- The field modelsCount in GET /api/v2/useCases/ and GET /api/v2/useCases/(useCaseId)/ is deprecated and will be removed in June 2025.

---
