Skip to content

Commit 0cf27c1

Browse files
jhosmanskedwards88
andauthored
Update "Securing webhooks" (#42622)
Co-authored-by: Sarah Edwards <skedwards88@github.com>
1 parent fae1df8 commit 0cf27c1

8 files changed

+285
-219
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: Editing webhooks
3+
intro: 'After creating a webhook, you can make changes to it.'
4+
versions:
5+
fpt: '*'
6+
ghes: '*'
7+
ghae: '*'
8+
ghec: '*'
9+
topics:
10+
- Webhooks
11+
---
12+
13+
## About editing webhooks
14+
15+
You can edit a webhook to change any of the settings that were selected when the webhook was initially created. For more information about the settings you can select while creating a webhook, see "[AUTOTITLE](/webhooks/using-webhooks/creating-webhooks)."
16+
17+
## Editing a repository webhook
18+
19+
You can edit a webhook that was created in a specific repository. You must be a repository owner or have admin access in the repository to edit webhooks in that repository.
20+
21+
You can use the {% data variables.product.prodname_dotcom %} web interface or the REST API to edit a repository webhook. For more information about using the REST API to edit a repository webhook, see "[AUTOTITLE](/rest/webhooks/repos#update-a-repository-webhook)."
22+
23+
{% data reusables.repositories.navigate-to-repo %}
24+
{% data reusables.repositories.sidebar-settings %}
25+
{% data reusables.webhooks.sidebar_webhooks %}
26+
{% data reusables.webhooks.edit_webhook %}
27+
{% data reusables.webhooks.edit_webhook_make_changes %}
28+
{% data reusables.webhooks.update_webhook %}
29+
30+
## Editing an organization webhook
31+
32+
You can edit a webhook that was created in a specific organization. You must be an organization owner to edit webhooks in that organization.
33+
34+
You can use the {% data variables.product.prodname_dotcom %} web interface or the REST API to edit an organization webhook. For more information about using the REST API to create an organization webhook, see "[AUTOTITLE](/rest/orgs/webhooks#update-an-organization-webhook)."
35+
36+
{% data reusables.repositories.navigate-to-repo %}
37+
{% data reusables.repositories.sidebar-settings %}
38+
{% data reusables.webhooks.sidebar_webhooks %}
39+
{% data reusables.webhooks.edit_webhook %}
40+
{% data reusables.webhooks.edit_webhook_make_changes %}
41+
{% data reusables.webhooks.update_webhook %}
42+
43+
{% ifversion ghes or ghae or ghec %}
44+
45+
## Editing a global webhook for a {% data variables.product.prodname_enterprise %}
46+
47+
Enterprise owners can edit a global webhook to change any of the settings that were selected when the webhook was initially created. For more information, see "[AUTOTITLE](/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/managing-global-webhooks#editing-a-global-webhook)."
48+
49+
{% endif %}
50+
51+
{% ifversion fpt or ghec %}
52+
53+
## Editing a {% data variables.product.prodname_marketplace %} webhook
54+
55+
You can edit a webhook that was created for an app that you published in {% data variables.product.prodname_marketplace %}. Only the owner of the app, or an app manager for the organization that owns the app, can edit a {% data variables.product.prodname_marketplace %} webhook. For more information, see "[AUTOTITLE](/apps/publishing-apps-to-github-marketplace/using-the-github-marketplace-api-in-your-app/webhook-events-for-the-github-marketplace-api)."
56+
57+
1. Navigate to your [{% data variables.product.prodname_marketplace %} listing page](https://github.com/marketplace/manage).
58+
1. Next to the {% data variables.product.prodname_marketplace %} listing that you want to view webhook deliveries for, click **Manage listing**.
59+
1. In the sidebar, click **Webhook**.
60+
{% data reusables.webhooks.edit_webhook_make_changes %}
61+
{% data reusables.webhooks.update_webhook %}
62+
63+
## Editing a {% data variables.product.prodname_sponsors %} webhook
64+
65+
You can edit a webhook that was created for a {% data variables.product.prodname_sponsors %} account. Only the owner of the sponsored account can edit sponsorship webhooks for that account. For more information, see "[AUTOTITLE](/sponsors/integrating-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account)."
66+
67+
{% endif %}
68+
69+
## Editing webhooks for a {% data variables.product.prodname_github_app %}
70+
71+
You can activate or deactivate a {% data variables.product.prodname_github_app %} webhook, change the webhook events that a {% data variables.product.prodname_github_app %} subscribes to, or make changes to other basic settings of a {% data variables.product.prodname_github_app %}'s webhook. For more information, see "[AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app-registration)."

content/webhooks/using-webhooks/index.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,10 @@ topics:
1111
children:
1212
- /creating-webhooks
1313
- /handling-webhook-deliveries
14-
- /securing-your-webhooks
14+
- /validating-webhook-deliveries
15+
- /editing-webhooks
1516
- /handling-failed-webhook-deliveries
1617
- /disabling-webhooks
1718
- /best-practices-for-using-webhooks
1819
---
20+

content/webhooks/using-webhooks/securing-your-webhooks.md

-215
This file was deleted.

0 commit comments

Comments
 (0)