Skip to main content
Manja / GitHub

Update an organization webhook

Updates a webhook configured in an organization. When you update a webhook, the `secret` will be overwritten. If you previously had a `secret` set, you must provide the same `secret` or set a new `secret` or the secret will be removed. If you are only updating individual webhook `config` properties, use "[Update a webhook configuration for an organization](/rest/reference/orgs#update-a-webhook-configuration-for-an-organization)."

PATCH/orgs/{org}/hooks/{hook_id}
Source
github-v3-rest.json
Revision
f5f067c1e6f6
Active snapshot
85e53e3d0d65

Request

Path Parameters
org string
required
hook_id integer
required
Body Params
optional
application/jsonobject
active boolean
optional

Determines if notifications are sent when the webhook is triggered. Set to `true` to send notifications.

Default: true

config object
optional

Key/value pairs to provide settings for this webhook. [These are defined below](https://docs.github.com/[email protected]/rest/reference/orgs#update-hook-config-params).

content_type webhook-config-content-type string
optional

The media type used to serialize the payloads. Supported values include `json` and `form`. The default is `form`.

Example: "json"

insecure_ssl webhook-config-insecure-ssl
optional
secret webhook-config-secret string
optional

If provided, the `secret` will be used as the `key` to generate the HMAC hex digest value for [delivery signature headers](https://docs.github.com/[email protected]/webhooks/event-payloads/#delivery-headers).

Example: "********"

url webhook-config-url string<uri>
required

The URL to which the payloads will be delivered.

Example: https://example.com/webhook

events array[string]
optional

Determines what [events](https://docs.github.com/[email protected]/webhooks/event-payloads) the hook is triggered for.

Default: [ "push" ]

name string
optional

Example: "web"

Responses

application/json Org Hook object

Response

active boolean
required

Example: true

config object
required
content_type string
optional

Example: "form"

insecure_ssl string
optional

Example: "0"

secret string
optional

Example: "********"

url string
optional

Example: "http://example.com/2"

created_at string<date-time>
required

Example: 2011-09-06T17:26:27Z

events array[string]
required
Example:
[
  "push",
  "pull_request"
]
id integer
required

Example: 1

name string
required

Example: web

ping_url string<uri>
required

Example: https://api.github.com/orgs/octocat/hooks/1/pings

type string
required
updated_at string<date-time>
required

Example: 2011-09-06T20:39:23Z

url string<uri>
required

Example: https://api.github.com/orgs/octocat/hooks/1

application/json Basic Error object

Resource not found

documentation_url string
optional
message string
optional
status string
optional
url string
optional
application/json Validation Error object

Validation failed

documentation_url string
required
errors array[object]
optional
items object
code string
required
field string
optional
index integer
optional
message string
optional
resource string
optional
value
optional
message string
required