[api] [monitors] Add option for force delete.

[phillip-dd]

What does this PR do?

Adds documentation and examples of using monitor delete with force, these options were added to clients and released:

• Add tests for options on delete datadogpy#513
• Add options for force delete monitors dogapi-rb#213

Motivation

MA-17

Preview link

https://docs-staging.datadoghq.com/pb/mon-del-force/api

Additional Notes

[athap]

Nit: missing new line

[athap]

👍

[iminoso]

Thanks for the update!

[zhengshizhao]

can we also update the code example for ruby client? and also fix typo in the ruby example https://a.cl.ly/z8unyXKr 62_625 => 62625
https://docs-staging.datadoghq.com/pb/mon-del-force/api/?lang=ruby#delete-a-monitor

[phillip-dd]

62_625 => 62625

Probably not a typo 😀 , valid ruby syntax, underscores can be used to separate digits, typically done as a replacement for commas for every 3 digits for readability.

[zhengshizhao]

62_625 => 62625

Probably not a typo 😀 , valid ruby syntax, underscores can be used to separate digits, typically done as a replacement for commas for every 3 digits for readability.

ah, thanks for checking that! my bad, will be more careful next time when I comment on any ruby code.

[ykyr]

Hi guys,
Are you sure API works according to the documentation?

I'm not able to force delete the monitor (that has reference in composite monitor) via API:
curl -X DELETE "https://api.datadoghq.com/api/v1/monitor/${monitor_id}?force=true&api_key=${api_key}&application_key=${app_key}"

{"errors":["Monitor is part of the following composite monitors: Test composite"]}

[ykyr]

Fixed by DD already.