List Webhooks

List all webhooks that belong to the authenticated user's organization. The response is paginated.

Webhook

GET /webhooks

Required permissions

Webhooks:Read (always required)

Authentication

Authentication Type	Supported
Organization User (CustomerEmployee)	Yes
Delegated User (EndUser)	No
Service Account	Yes

Authorization

Header	Type	Required	Description
Authorization	string	Yes	Bearer token used to authenticate the request. See Authentication flows for instructions on generating this token.

Query parameter

Parameter	Type	Required	Description
limit	integer	No	Maximum number of webhook objects to return. Must be greater than 0 and no more than 200.
paginationToken	string	No	Token for retrieving the next page of results. Minimum length is 1.

Request body

curl --request GET \
  --url https://api.digitalassets.ibm.com/webhooks \
  --header 'Authorization: Bearer <token>'

Response

200: Success

{
  "items": [
    {
      "id": "<string>",
      "url": "<string>",
      "events": [
        "policy.triggered"
      ],
      "status": "Enabled",
      "dateCreated": "<string>",
      "dateUpdated": "<string>",
      "description": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}