GET

Find webhooks

Find webhooks. The authenticated user must be an administrator to call this resource.

Request

Query parameters

limit

string

start

string

event

string

statistics

string

Responses

returns a list of webhooks.

application/json

object
GET/rest/api/webhooks
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 { "results": [ { "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "username": "<string>", "password": "<string>" } } ], "totalCount": 2154, "start": 25, "limit": 25, "size": 25, "_links": { "base": "http://localhost:8085/confluence", "context": "confluence", "self": "http://localhost:8085/rest/api/latest/..?limit=25&start=25", "next": "http://localhost:8085/rest/api/latest/..?limit=25&start=50", "prev": "http://localhost:8085/rest/api/latest/..?limit=25&start=0" } }
POST

Create webhook

Create a webhook via the URL. The authenticated user must be an administrator to call this resource.

Request

Request bodyapplication/json

the webhook to be created.

scopeType

string

events

array<string>

active

boolean

sslVerificationRequired

boolean

name

string

configuration

object

url

string

credentials

RestWebhookCredentials

statistics

object

Responses

returns a created webhook.

application/json

Webhook
POST/rest/api/webhooks
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 curl --request POST \ --url 'http://{baseurl}/confluence/rest/api/webhooks' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "username": "<string>", "password": "<string>" }, "statistics": {} }'
201Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 { "createdDate": "<string>", "updatedDate": "<string>", "sslVerificationRequired": true, "events": [ { "i18nKey": "<string>", "id": "<string>" } ], "name": "<string>", "id": 2154, "scope": { "id": "<string>", "type": "<string>" }, "active": true, "configuration": {}, "url": "<string>", "credentials": { "username": "<string>", "password": "<string>" } }
GET

Get webhook

Get a webhook by id. The authenticated user must be an administrator to call this resource.

Request

Path parameters

webhookId

string

Required

Query parameters

statistics

boolean

Responses

returns a webhook.

application/json

RestWebhook
GET/rest/api/webhooks/{webhookId}
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "username": "<string>", "password": "<string>" } }
PUT

Update webhook

Update an existing webhook. The authenticated user must be an administrator to call this resource.

Request

Path parameters

webhookId

string

Required

Request bodyapplication/json

the representation of the updated values for the webhook

scopeType

string

events

array<string>

active

boolean

sslVerificationRequired

boolean

name

string

configuration

object

url

string

credentials

RestWebhookCredentials

statistics

object

Responses

returns a webhook.

application/json

RestWebhook
PUT/rest/api/webhooks/{webhookId}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 curl --request PUT \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "username": "<string>", "password": "<string>" }, "statistics": {} }'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "username": "<string>", "password": "<string>" } }
DEL

Delete webhook

Delete a webhook via the URL. The authenticated user must be an administrator to call this resource.

Request

Path parameters

webhookId

string

Required

Responses

returned if deleted successfully.

DEL/rest/api/webhooks/{webhookId}
1 2 curl --request DELETE \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}'
GET

Get latest invocations

Get the latest invocations for a specific webhook. The authenticated user must be an administrator to call this resource.

Request

Path parameters

webhookId

string

Required

Query parameters

outcomes

string

event

string

outcome

array<string>

Responses

returns a webhook invocation dataset.

application/json

DetailedInvocation
GET/rest/api/webhooks/{webhookId}/latest
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}/latest' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 { "result": { "outcome": "ERROR", "description": "<string>" }, "request": { "body": "<string>", "headers": {}, "method": "GET", "url": "<string>" }, "start": "<string>", "finish": "<string>", "eventScope": { "id": "<string>", "type": "<string>" }, "id": "<string>", "duration": { "seconds": 2154, "zero": true, "nano": 2154, "negative": true, "positive": true, "units": [ { "durationEstimated": true, "duration": { "seconds": 2154, "zero": true, "nano": 2154, "negative": true, "positive": true }, "timeBased": true, "dateBased": true } ] }, "event": { "i18nKey": "<string>", "id": "<string>" } }
GET

Get statistic

Get the statistics for a specific webhook. The authenticated user must be an administrator to call this resource.

Request

Path parameters

webhookId

string

Required

Query parameters

event

string

Responses

returns a webhook invocation dataset.

application/json

RestInvocationHistory

GET/rest/api/webhooks/{webhookId}/statistics
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}/statistics' \ --header 'Accept: application/json'
GET

Get statistics summary

Get the statistics summary for a specific webhook. The authenticated user must be an administrator to call this resource.

Request

Path parameters

webhookId

string

Required

Responses

returns a webhook invocation dataset.

application/json

RestInvocationHistory

GET/rest/api/webhooks/{webhookId}/statistics/summary
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}/statistics/summary' \ --header 'Accept: application/json'
POST

Test webhook

Test connectivity to a specific endpoint. The authenticated user must be an administrator to call this resource.

Request

Query parameters

url

string

Required

Responses

returns a webhook.

application/json

any

POST/rest/api/webhooks/test
1 2 3 curl --request POST \ --url 'http://{baseurl}/confluence/rest/api/webhooks/test?url={url}' \ --header 'Accept: application/json'

Rate this page: