WebhooksApi
| Method | HTTP request | Description |
|---|---|---|
| createWebhookUsingPOST | POST /api/web/v1/webhooks | Register a webhook |
| deleteWebhookUsingDELETE | DELETE /api/web/v1/webhooks/{id} | Delete a webhook |
| getWebhooksUsingGET | GET /api/web/v1/webhooks | List webhooks |
| readWebhookUsingGET | GET /api/web/v1/webhooks/{id} | Get a webhook by id |
| testWebhookUsingPOST | POST /api/web/v1/webhooks/test/{id} | Test a webhook |
| updateWebhookUsingPUT | PUT /api/web/v1/webhooks/{id} | Update a webhook |
createWebhookUsingPOST
Webhook createWebhookUsingPOST(webhookParms)
Register a webhook
Register a webhook with callback URL, webhook events etc. Caller is required to have WEBHOOKS:ADD permission.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| webhookParms | WebhookParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
deleteWebhookUsingDELETE
deleteWebhookUsingDELETE(id)
Delete a webhook
Delete a registered webhook by ID. Caller is required to have WEBHOOKS:REMOVE permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | String | The UUID of the webhook to be deleted. |
Return type
null (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
getWebhooksUsingGET
List<Webhook> getWebhooksUsingGET()
List webhooks
Return a list of webhooks. Caller is required to have WEBHOOKS:VIEW permission.
Example
Parameters
This endpoint does not need any parameter.
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
readWebhookUsingGET
Webhook readWebhookUsingGET(id)
Get a webhook by id
Get the specified webhook. Caller is required to have WEBHOOKS:VIEW permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | String | The UUID of the webhook. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
testWebhookUsingPOST
testWebhookUsingPOST(id)
Test a webhook
Sends a dummy payload to the registered webhook callback URL. Use this to ensure your API is ready to start accepting webhook notifications. Caller is required to have WEBHOOKS:EDIT permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | String | The UUID of the webhook to test. |
Return type
null (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
updateWebhookUsingPUT
Webhook updateWebhookUsingPUT(id, webhookParms)
Update a webhook
Update a webhook with callback URL, webhook events etc. Caller is required to have WEBHOOKS:EDIT permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | String | The UUID of the webhook to be updated. | |
| webhookParms | WebhookParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |