Migration guides for deprecated APIs

The following APIs have been deprecated. For backward compatibility, the endpoints remain functional until further notice, but we recommend that you use the new options instead.

Every deprecated endpoint will eventually reach end of life (EOL) and be disabled. You won't be able to use them afterward. We provide enough time to switch to the new option before shutting down the old one. Even if the EOL date is not defined, you still should adapt your integrations to the new options.

Deprecated API	What to use instead	Deprecated in version	Migration guide
Credential vault API[Configuration]	Credential vault API[Environment]	1.252
Events API v1	Events API v2	SaaS 1.243 Managed 1.244	Events v1 to Events v2
Problems API v1	Problems API v2	SaaS 1.243 Managed 1.244	Problems v1 to Problems v2
Tokens API v1	Access tokens API	1.242	Tokens v1 to Access tokens
Thresholds API	Anomaly detection API - Metric event	SaaS 1.189 Managed 1.190
Maintenance windows API [Environment]	Maintenance windows API [Configuration]	SaaS 1.173 Managed 1.174

The following APIs have been migrated to the Settings 2.0 framework. Migrated configurations are handled via Settings API with a related schema.

Deprecated API	Schema to use instead	Deprecated in version	End of life in version
Alerting profiles API	Problem alerting profiles (`builtin:alerting.profile`)	SaaS 1.249 Managed 1.250
Frequent issue detection API	Frequent issue detection (`builtin:anomaly-detection.frequent-issues`)	SaaS 1.249 Managed 1.250
Notifications API	Problem notifications (`builtin:problem.notifications`)	SaaS 1.249 Managed 1.250
OneAgent on a host API - Monitoring configuration	Monitoring (`builtin:host.monitoring`)	1.244
Maintenance windows API	Maintenance windows (`builtin:alerting.maintenance-window`)	1.240
IBM MQ Tracing API	IBM MQ IMS bridges (`builtin:ibmmq.ims-bridges`) IBM MQ queue sharing groups (`builtin:ibmmq.queue-sharing-group`) IBM MQ queue managers (`builtin:ibmmq.queue-managers`)	1.238	1.250