Delete a system hook

DELETE

/api/v4/hooks/{hook_id}

• GitLab REST API

Deletes a specified system hook. Administrators only.

Authorizations

• http
• oauth2

Parameters

Path Parameters

hook_id

required

integer

The ID of the system hook

Responses

204

No Content

Media type application/json

object

id

integer format: int64

url

string

name

string

description

string

created_at

string format: date-time

push_events

boolean

tag_push_events

boolean

merge_requests_events

boolean

repository_update_events

boolean

enable_ssl_verification

boolean

organization_id

integer

alert_status

string

disabled_until

string format: date-time

url_variables

Array<object>

object

push_events_branch_filter

string

branch_filter_strategy

string

custom_webhook_template

string

custom_headers

Array<object>

object

token_present

Whether a secret token is configured

boolean

signing_token_present

Whether an HMAC signing token is configured

boolean

Example

{
  "id": 1,
  "url": "https://webhook.site",
  "name": "Hook name",
  "description": "Hook description",
  "created_at": "2012-05-28T04:42:42-07:00",
  "organization_id": 1,
  "alert_status": ":executable",
  "disabled_until": "2012-05-28T04:42:42-07:00",
  "url_variables": [
    {
      "token": "secr3t"
    }
  ],
  "push_events_branch_filter": "my-branch-*",
  "branch_filter_strategy": "wildcard",
  "custom_webhook_template": "{\"event\":\"{{object_kind}}\"}",
  "custom_headers": [
    {
      "X-Custom-Header": "value"
    }
  ],
  "token_present": false,
  "signing_token_present": false
}

400

Bad Request

404

Not found