Error when creating singular Condition for webhook #5959

New Issue

adam · 2025-12-29T19:34:56+01:00

adam commented

2025-12-29 19:34:56 +01:00

Originally created by @kkthxbye-code on GitHub (Jan 18, 2022).

Originally assigned to: @jeremystretch on GitHub.

NetBox version

v.3.1.5

Python version

3.9

Steps to Reproduce

Click on Other -> Webhooks
Add new webhook
Enter the following data: name = test, content types = DCIM > Device, URL: http://127.0.0.1/
Enter the following condition copied from the documentation:

{
  "attr": "name",
  "value": "foo"
}

Save

Expected Behavior

Webhook saves

Observed Behavior

The following error: Ruleset must have exactly one logical operator (found 2)

The following works:

{
    "and": [
        {
            "attr": "name",
            "value": "foo"
        }
    ]
}

Now looking at the code, I'm not sure if this is a bug or I'm just misunderstanding the documentation. To me the documentation implies that singular conditions are allowed at the root level, and only at the bottom of the page are Condition Sets documented.

If I'm just misunderstanding, is the correct way just to wrap singular conditions in the "and" operator?

Condition documentation: https://netbox.readthedocs.io/en/stable/reference/conditions/

Conditional webhooks documentation: https://netbox.readthedocs.io/en/stable/additional-features/webhooks/#conditional-webhooks

Originally created by @kkthxbye-code on GitHub (Jan 18, 2022). Originally assigned to: @jeremystretch on GitHub. ### NetBox version v.3.1.5 ### Python version 3.9 ### Steps to Reproduce 1. Click on Other -> Webhooks 2. Add new webhook 3. Enter the following data: name = test, content types = DCIM > Device, URL: http://127.0.0.1/ 4. Enter the following condition copied from the documentation: ``` { "attr": "name", "value": "foo" } ``` 5. Save ### Expected Behavior Webhook saves ### Observed Behavior The following error: Ruleset must have exactly one logical operator (found 2) The following works: ``` { "and": [ { "attr": "name", "value": "foo" } ] } ``` Now looking at the code, I'm not sure if this is a bug or I'm just misunderstanding the documentation. To me the documentation implies that singular conditions are allowed at the root level, and only at the bottom of the page are Condition Sets documented. If I'm just misunderstanding, is the correct way just to wrap singular conditions in the "and" operator? Condition documentation: https://netbox.readthedocs.io/en/stable/reference/conditions/ Conditional webhooks documentation: https://netbox.readthedocs.io/en/stable/additional-features/webhooks/#conditional-webhooks

adam added the status: accepted type: documentation labels 2025-12-29 19:34:56 +01:00

adam closed this issue

2025-12-29 19:34:56 +01:00

adam commented

2025-12-29 19:34:57 +01:00

@jeremystretch commented on GitHub (Jan 18, 2022):

IIRC the original intent was to support the simplified expression where only a single AND clause is present, however the implementation to accommodate it proved too unwieldy and was scrapped. The example in the webhook documentation did not get updated to reflect this change.

@jeremystretch commented on GitHub (Jan 18, 2022): IIRC the original intent was to support the simplified expression where only a single AND clause is present, however the implementation to accommodate it proved too unwieldy and was scrapped. The example in the webhook documentation did not get updated to reflect this change.

Sign in to join this conversation.

Branches Tags

main

update-changelog-comments-docs

feature-removal-issue-type

20911-dropdown

20239-plugin-menu-classes-mutable-state

21097-graphql-id-lookups

feature

fix_module_substitution

20923-dcim-templates

20044-elevation-stuck-lightmode

feature-ip-prefix-link

v4.5-beta1-release

20068-import-moduletype-attrs

20766-fix-german-translation-code-literals

20378-del-script

7604-filter-modifiers-v3

circuit-swap

12318-case-insensitive-uniqueness

20637-improve-device-q-filter

20660-script-load

19724-graphql

20614-update-ruff

14884-script

02496-max-page

19720-macaddress-interface-generic-relation

19408-circuit-terminations-export-templates

20203-openapi-check

fix-19669-api-image-download

7604-filter-modifiers

19275-fixes-interface-bulk-edit

fix-17794-get_field_value_return_list

11507-show-aggregate-and-rir-on-api

9583-add_column_specific_search_field_to_tables

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/netbox#5959