Summary:
Inspect or delete a custom webhook group.
URL:
http(s)://{server hostname}/api/webhooks/groups/{group name}
Methods summary
- GET Method - inspect a custom webhook group
- PUT Method - modify a custom webhook group
- DELETE Method - delete a custom webhook group
GET Method detail
Returns information about the specified custom webhook group.
Response:
Information about the custom webhook group in the following format:
Name | Description |
---|---|
groupID |
ID of the group. |
groupName | group name. |
authType |
type of authentication, choose from: 1 = basic 3 = API Key Header 4 = API Key Body 5 = API Key Query |
authKey | name of the authentication key. This field is not applicable if the Basic authentication type is selected. |
endpointCount | number of webhook endpoints assigned to this webhook group. |
ruleCount | number of webhook rules associated with this webhook group. |
Example:
INPUT
curl -v -u -k admin:admin https://localhost/api/webhooks/groups/anewgroup?media=json -H "content-type:application/json"
OUTPUT
{
"groupID" : 24,
"groupName" : "Anewgroup",
"authMethod" : {
"authType" : 1,
"authKey" : "not used"
},
"endpointCount" : 0,
"ruleCount" : 0
},
PUT Method detail
Modifies the specified custom webhook group.
Response:
Name | Description |
---|---|
groupID |
ID of the group. |
groupName | group name. |
authType |
type of authentication, choose from: 1 = basic 3 = API Key Header 4 = API Key Body 5 = API Key Query |
authKey | name of the authentication key. This field is not applicable if the Basic authentication type is selected. |
Example:
INPUT
curl -u admin:admin -k https://localhost/api/webhooks/groups/anewgroup -H 'content-type:application/json' -X PUT
{
"groupID" : "24",
"groupName" : "Anewgroup",
"authMethod" : {
"authType" : 1,
"authKey" : "not used"
},
}
OUTPUT
{
"successCount" : 1,
"failureCount" : 0,
"errorCode" : 0,
"message" : "Succeeded to edit Webhook group 'anewgroup'.",
"otherResults" : [ ]
}
DELETE Method detail
Deletes the specified custom webhook group.
Response:
Confirmation that the group has been deleted.
Example:
INPUT
curl -u admin:admin -k https://localhost/api/webhooks/groups/anewgroup -H 'content-type:application/json' -X DELETE
OUTPUT
{
"successCount" : 1,
"failureCount" : 0,
"errorCode" : 0
"message" : "Groups deleted successfully.",
"otherResults" : []
}
Comments
0 comments
Please sign in to leave a comment.