Add the ‘Delete Knowledge’ Tool step to your Tool

You can add the ‘Delete Knowledge’ Tool step to your Tool by:

  1. Creating a new Tool, then searching for the ‘Delete Knowledge’ Tool step

  2. Click ‘Expand’ to see the full Tool step

  3. Select the knowledge set you would like to use.

  4. Filter condition: “and” vs “or” when matching data to delete:

    • Use and when all specified conditions must match for a row to be deleted.
    • Use or when any of the conditions can match.

    Filter condition only applies if you include more than one object in the filter

  5. Filters: Accepts an array of objects, where each object corresponds to a row. Add more objects to delete multiple rows at once.

Common errors

Formatting Examples

Example 1: Delete single condition

// All poodles will be deleted
[
  {
    "breed": "poodle"
  }
]

Example 2: Delete single condition

// All small poodles will be deleted
[
  {
    "breed": "poodle",
	"size": "small"
  }
]

Example 3: Delete multiple conditions (or)

// All small poodles will be deleted AND any dog aged 4 will be deleted
[
  {
    "breed": "poodle",
    "size": "small"
  }, 
  {
    "age": 4
  }
]

Example 3: Delete multiple conditions (and)

// Only small poodles that are aged 4 will be deleted
[
  {
    "breed": "poodle",
    "size": "small"
  }, 
  {
    "age": 4
  }
]

Ensure to separate each object with a comma if inserting multiple rows.

Frequently asked questions

What’s the difference between using “AND” and “OR”?

  • Use AND when all filter conditions must be true for a row to be deleted.
  • Use OR when any one of the conditions can match.

This only applies when you include more than one object in the filter array.

Can I delete multiple rows at once?

Yes. Any row that matches the filter condition you have specified will be deleted.

What if my filters don’t match any rows?

If no rows match the provided conditions, no data will be deleted. Make sure your filter values exactly match the data in the knowledge set (e.g., casing, field names, etc.).