How to Disable Policies via the API Developer Guide

Learn how to turn policies on and off through the API.

You can use the Metricly CLI or interact directly with the Metricly API to manipulate policies. A common need from some of our users is to temporarily disable their policies while building, testing, or modifying them. This short guide walks you through how to do that via the Policy API directly.

1. Get Policy ID.

  1. In Metricly, navigate to the policy you want to edit.
  2. Copy the policy’s ID from the url.

2. Get & Put the Policy Document via Swagger

  1. GET from /policies/getPolicyUsingGET
      "policy": {
        "id": "12345a123-ab12-12345-bc12-23456a78",
        "name": "RabbitMQ: Messages in the dead letter queues",
        "description": "RabbitMQ: Messages in the dead letter queues",
        "scope": {
          "elementName": null,
          "elementNameExclude": null,
          "fqnIncludes": [
          "fqnExcludes": [
          "elementType": null,
          "elementTypes": [
          "elementTags": [
          "elementTagsAll": true,
          "excludedElementTags": [
          "elementAttributes": [
          "elementAttributesAll": true,
          "excludedElementAttributes": [
        "duration": 300,
        "conditions": [
            "metric": null,
            "wildcard": "rabbitmq.queues.*(_dl|_dlq).messages",
            "metricScopeTags": {
            "analytic": "actual",
            "operator": ">",
            "level": 1,
            "level2": null,
            "metricThresholdLevel": null,
            "metricThresholdAnalytic": null
        "eventConditions": [
        "checkCondition": null,
        "actions": [
            "type": "event",
            "category": 3
            "type": "notification",
            "id": 12345,
            "enabled": true,
            "notifyFrequencyMin": 1234,
            "sendOnClear": true
        "enabled": true,
        "deleted": false,
        "creatorEmail": "",
        "lastUpdated": "2018-06-01T20:32:05Z"
  2. Change "enabled": true, to "enabled": false in the policy document.
  3. PUT to /policies/updatePolicyUsingPUT

3.  Done!

You can repeat section 2 to re-enable your policy. Want to make other changes via endpoints? Read more about our Policy API.


Join other DevOps who love Metricly!

Sign up for a free, fully featured, 21-day trial. No credit card required!