[BUG] Alerting API throws 405 error

[prudhvigodithi]

What is the bug?
Following the documentation to create an alerting destination https://opensearch.org/docs/latest/observing-your-data/alerting/api/#create-destination, I have the following command

curl -XPOST "http://admin:admin@localhost:9200/_plugins/_alerting/destinations" -d "{'name': 'my-destination','type': 'slack','slack': {'url': 'http://www.example.com/'}}"  -H 'Content-Type: application/json'

However I get the following error:

{"error":"Incorrect HTTP method for uri [/_plugins/_alerting/destinations] and method [POST], allowed: [GET]","status":405}

For 1.x it used be /_opendistro/_alerting/destinations and works fine but /_plugins/_alerting/destinations throws 405 error. Is this a bug from alerting API?

Do you have any additional context?
I’m working on to adding 2.x support for terraform provider opensearch-project/terraform-provider-opensearch#62 and found this issue.
Related Issues:
opensearch-project/terraform-provider-opensearch#30
opensearch-project/documentation-website#1994
https://forum.opensearch.org/t/unable-to-create-alerting-destination-in-v2-1-0/10479

[prudhvigodithi]

The notifications API works _plugins/_notifications/configs
https://opensearch.org/docs/latest/observing-your-data/notifications/api/
so the destination is now called channel ?

curl -d '{
  "config_id": "sample-id",
  "name": "sample-name",
  "config": {
    "name": "Sample Slack Channel",
    "description": "This is a Slack channel",
    "config_type": "slack",
    "is_enabled": true,
    "slack": {
      "url": "https://sample-slack-webhook/"
    }
  }
}' -H "Content-Type: application/json" -X POST 'http://admin:admin@localhost:9200/_plugins/_notifications/configs/'

[lezzago]

Oh the documentation is not updated. Alerting destinations have been deprecated in 2.0 and we do not allow the creation of new alerting destinations. The user needs to use Notification channels instead.