v1

latestOpenAPI 3.0.32026-07-26191565482.4 KB
DropRule

put/api/v1/config/drop-rules/{slug}

Path parameters

slugstring required

Request body

create_if_missingboolean

If true, the DropRule will be created if it does not already exist, identified by slug. If false, an error will be returned if the DropRule does not already exist.

dry_runboolean

If true, validates the specified configuration without creating or updating the DropRule. If the specified configuration is valid, the endpoint returns a partial response without the DropRule. If the specified configuration is invalid, the endpoint returns an error.

Example request

{
  "drop_rule": {
    "filters": [
      {
        "name": "job",
        "value_glob": "myservice*"
      }
    ]
  }
}

Response

A successful response containing the updated DropRule.

Example response

{
  "drop_rule": {
    "filters": [
      {
        "name": "job",
        "value_glob": "myservice*"
      }
    ]
  }
}