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
Topology and Smartscape	Monitored entities	1.263	Topology and Smartscape to Monitored entities
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	Migration guide
Remote environments API	Remote environment (`builtin:remote.environment`)	1.274
Anomaly detection API - Metric events	Metric events (`builtin:anomaly-detection.metric-events`)	SaaS 1.265 Managed 1.266		Metric events to Settings 2.0
Alerting profiles API	Problem alerting profiles (`builtin:alerting.profile`)	SaaS 1.249 Managed 1.250		Alerting profiles to Settings 2.0
Frequent issue detection API	Frequent issue detection (`builtin:anomaly-detection.frequent-issues`)	SaaS 1.249 Managed 1.250		Frequent issue detection to Settings 2.0
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		Maintenance windows to Settings 2.0
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