Manage webhooks
Estimated reading time: 2 minutesThis topic applies to Docker Enterprise.
The Docker Enterprise platform business, including products, customers, and employees, has been acquired by Mirantis, inc., effective 13-November-2019. For more information on the acquisition and how it may affect you and your business, refer to the Docker Enterprise Customer FAQ.
You can configure DTR to automatically post event notifications to a webhook URL of your choosing. This lets you build complex CI and CD pipelines with your Docker images. The following is a complete list of event types you can trigger webhook notifications for via the web interface or the API.
Webhook types
| Event Type | Scope | Access Level | Availability |
|---|---|---|---|
Tag pushed to repository (TAG_PUSH) |
Individual repositories | Repository admin | Web UI & API |
Tag pulled from repository (TAG_PULL) |
Individual repositories | Repository admin | Web UI & API |
Tag deleted from repository (TAG_DELETE) |
Individual repositories | Repository admin | Web UI & API |
Manifest pushed to repository (MANIFEST_PUSH) |
Individual repositories | Repository admin | Web UI & API |
Manifest pulled from repository (MANIFEST_PULL) |
Individual repositories | Repository admin | Web UI & API |
Manifest deleted from repository (MANIFEST_DELETE) |
Individual repositories | Repository admin | Web UI & API |
Security scan completed (SCAN_COMPLETED) |
Individual repositories | Repository admin | Web UI & API |
Security scan failed (SCAN_FAILED) |
Individual repositories | Repository admin | Web UI & API |
Image promoted from repository (PROMOTION) |
Individual repositories | Repository admin | Web UI & API |
Image mirrored from repository (PUSH_MIRRORING) |
Individual repositories | Repository admin | Web UI & API |
Image mirrored from remote repository (POLL_MIRRORING) |
Individual repositories | Repository admin | Web UI & API |
Repository created, updated, or deleted (REPO_CREATED, REPO_UPDATED, and REPO_DELETED) |
Namespaces / Organizations | Namespace / Org owners | API Only |
Security scanner update completed (SCANNER_UPDATE_COMPLETED) |
Global | DTR admin | API only |
You must have admin privileges to a repository or namespace in order to subscribe to its webhook events. For example, a user must be an admin of repository “foo/bar” to subscribe to its tag push events. A DTR admin can subscribe to any event.