Manage Webhooks
    • PDF

    Manage Webhooks

    • PDF

    Article summary

    1. Update Audit Log Webhook

    This POST method is used to save or update audit log webhooks. A tenant can have multiple webhooks for different notificationMediumIds. If the notificationMediumId already exists, the existing webhook is updated.

    POST{{url}}/api/logs/webhooks

    Request Example

    curl --location --request POST '{{url}}/api/logs/webhooks' \
    --header 'Authorization: TOKEN {{apiToken}}'
    --data-raw '{
      "notificationMediumId": "string",
      "filter": "string",
      "description": "string"
    }'

    Response Example 

    Status: 200 OK
    {
      "notificationMediumId": "string",
      "filter": "string",
      "description": "string"
    }

    2. Retrieve Audit Log Webhook Details

    This GET method is used to retrieve audit log webhook details for the tenant.

    GET{{url}}/api/logs/webhooks

    Request Example

    curl --location --request GET '{{url}}/api/logs/webhooks' \
    --header 'Authorization: TOKEN {{apiToken}}'

    Response Example 

    Status: 200 OK
    [
      {
        "notificationMediumId": "string",
        "filter": "string",
        "description": "string"
      }
    ]

    3. Retrieve WebHook Details by Notification Medium ID

    This GET method is used to retrieve audit log webhook details specified by notificationMediumId..

    GET{{url}}/api/logs/webhooks/{notificationMediumId}

    Request Parameters

    The request parameters used in this method are shown in the following table:

    ParameterDescriptionData TypeRequired
    notificationMediumId
    Notification medium ID.StringMandatory

    Request Example

    curl --location --request GET '{{url}}/api/logs/webhooks/{notificationMediumId} \
    --header 'Authorization: TOKEN {{apiToken}}

    Response Example 

    Status: 200 OK
    {
      "notificationMediumId": "string",
      "filter": "string",
      "description": "string"
    }

    4. Delete Audit Log Webhook

    This DELETE method deletes an audit log webhook.

    DELETE{{url}}/api/logs/webhooks/{notificationMediumId}

    Request Parameters

    The request parameters used in this method are shown in the following table:

    ParameterDescriptionData TypeRequired
    notificationMediumId
    Notification medium ID.StringMandatory

    Request Example

    curl --location --request DELETE '{{url}}/api/logs/webhooks/{notificationMediumId}' \ --header 'Authorization: TOKEN {{apiToken}}'

    Response Example 

    Status: 204 No Content

    Was this article helpful?

    What's Next