v1

latestOpenAPI 3.1.02026-07-1744202324.0 KB
Webhooks

Get a webhook

Get a webhook by ID.

get/v2/webhooks/{webhook_id}

Path parameters

webhook_idstring required

ID of webhook to get

Response

Response from the GET /v2/webhooks/{webhook_id} endpoint.

idstring required

The ID of the webhook

event_type'PING' | 'FILE_UPDATE' | 'FILE_VERSION_UPDATE' | 'FILE_DELETE' | 'LIBRARY_PUBLISH' | 'FILE_COMMENT' required

An enum representing the possible events that a webhook can subscribe to

team_idstring required

The team id you are subscribed to for updates

status'ACTIVE' | 'PAUSED' required

An enum representing the possible statuses you can set a webhook to:

  • ACTIVE: The webhook is healthy and receive all events
  • PAUSED: The webhook is paused and will not receive any events
client_idstring nullable required

The client ID of the OAuth application that registered this webhook, if any

passcodestring required

The passcode that will be passed back to the webhook endpoint

endpointstring required

The endpoint that will be hit when the webhook is triggered

descriptionstring nullable required

Optional user-provided description or name for the webhook. This is provided to help make maintaining a number of webhooks more convenient. Max length 140 characters.