Delete Automation Connector (Webhook)

Delete Automation Connector (Webhook)#

Delete an existing automation connector (webhook) from incident and event management integrations.

✅ All code examples tested: Verified against FortiAnalyzer v7.4.8, v7.6.4, v8.0.0.

Overview#

This endpoint deletes automation connectors - useful for:

  • Removing deprecated or unused webhook integrations

  • Cleaning up test connectors

  • Decommissioning retired SIEM/SOAR/ticketing integrations

  • Managing connector lifecycle

  • Security auditing and connector inventory management

Endpoint Details#

Method: POST URL: /jsonrpc API Path: /config/adom/{adom}/system/webhook ADOM Support: Yes Requires Authentication: Yes Minimum Version: 7.4.0

Prerequisites#

  • Active session or valid API key

  • Administrative access to system configuration in specified ADOM

  • Connector name to delete

Request Format#

Parameters#

Parameter

Type

Required

Default

Description

adom

string

Yes

-

ADOM name (e.g., “root”)

filter

array

Yes

-

Filter array: [“name”, “in”, “connector_name”]

confirm

integer

Yes

-

Confirmation: 1 to proceed with deletion

Request Example#

{
    "method": "delete",
    "params": [{
        "url": "/config/adom/root/system/webhook",
        "confirm": 1,
        "filter": ["name", "in", "Splunk_HEC"]
    }],
    "session": "{{session_id}}",
    "id": 1
}

{
    "result": [{
        "data": {},
        "status": {
            "code": 0,
            "message": "OK"
        },
        "url": "/config/adom/root/system/webhook"
    }],
    "session": "{{session_id}}",
    "id": 1
}

Complete Python Example#

import requests
import urllib3

urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)

def delete_automation_connector(session_id, adom, connector_name):
    """
    Delete automation connector (webhook)

    Args:
        session_id: Active session ID
        adom: ADOM name
        connector_name: Name of connector to delete

    Returns:
        bool: True if successful
    """
    url = "https://faz.example.com/jsonrpc"

    payload = {
        "method": "delete",
        "params": [{
            "url": f"/config/adom/{adom}/system/webhook",
            "confirm": 1,
            "filter": ["name", "in", connector_name]
        }],
        "session": session_id,
        "id": 1
    }

    response = requests.post(url, json=payload, verify=False)
    result = response.json()

    if result['result'][0]['status']['code'] == 0:
        print(f"✓ Automation connector '{connector_name}' deleted successfully")
        return True
    else:
        raise Exception(f"API error: {result['result'][0]['status']['message']}")

# Example: Delete specific connector
delete_automation_connector(
    session_id="your_session_id",
    adom="root",
    connector_name="Splunk_HEC"
)

Use Cases#

Remove Deprecated Connector#

# Delete old test connector
delete_automation_connector(
    session_id=session,
    adom="root",
    connector_name="Test_Webhook_Old"
)

Cleanup Multiple Connectors#

# Delete multiple unused connectors
deprecated_connectors = [
    "Old_Splunk_Test",
    "Deprecated_QRadar",
    "Test_ServiceNow"
]

for connector in deprecated_connectors:
    try:
        delete_automation_connector(
            session_id=session,
            adom="root",
            connector_name=connector
        )
        print(f"✓ Deleted: {connector}")
    except Exception as e:
        print(f"✗ Failed to delete {connector}: {e}")

Safe Delete with Verification#

# Verify connector exists before deleting
from get_fabric_conector import get_automation_connectors

connectors = get_automation_connectors(session_id=session, adom="root")
connector_names = [c['name'] for c in connectors]

connector_to_delete = "Old_Integration"

if connector_to_delete in connector_names:
    # Confirm deletion
    confirm = input(f"Delete connector '{connector_to_delete}'? (yes/no): ")

    if confirm.lower() == 'yes':
        delete_automation_connector(
            session_id=session,
            adom="root",
            connector_name=connector_to_delete
        )
else:
    print(f"✗ Connector '{connector_to_delete}' not found")

Best Practices#

⚠️ Warning: Deletion is permanent and cannot be undone. Verify the connector name before deletion.

💡 Tip: List all connectors first using Get Automation Connectors to ensure you’re deleting the correct one.

💡 Tip: Export connector configuration before deletion for backup purposes.

⚠️ Warning: Deleting an active connector will immediately stop event forwarding to that system.

On this page