v1

latestOpenAPI 3.0.32026-07-26191565482.4 KB
MappingRule

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

Path parameters

slugstring required

Request body

create_if_missingboolean

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

dry_runboolean

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

Example request

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

Response

A successful response containing the updated MappingRule.

Example response

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