Module: Gitlab::Client::SystemHooks

Included in:
Gitlab::Client
Defined in:
lib/gitlab/client/system_hooks.rb

Overview

Defines methods related to system hooks.

Instance Method Summary collapse

Instance Method Details

#add_hook(url, options = {}) ⇒ Gitlab::ObjectifiedHash Also known as: add_system_hook

Adds a new system hook.

Examples:

Gitlab.add_hook('http://example.com/hook')
Gitlab.add_system_hook('https://api.example.net/v1/hook')

Options Hash (options):

  • :token (String)

    A secret token for Gitlab to send in the `X-Gitlab-Token` header for authentication.

  • :enable_ssl_verification (boolean)

    `false` will cause Gitlab to ignore invalid/unsigned certificate errors (default is `true`)


33
34
35
# File 'lib/gitlab/client/system_hooks.rb', line 33

def add_hook(url, options = {})
  post('/hooks', body: options.merge(url: url))
end

#delete_hook(id) ⇒ Gitlab::ObjectifiedHash Also known as: delete_system_hook

Deletes a new system hook.

Examples:

Gitlab.delete_hook(3)
Gitlab.delete_system_hook(12)

59
60
61
# File 'lib/gitlab/client/system_hooks.rb', line 59

def delete_hook(id)
  delete("/hooks/#{id}")
end

#hook(id) ⇒ Array<Gitlab::ObjectifiedHash> Also known as: system_hook

Tests a system hook.

Examples:

Gitlab.hook(3)
Gitlab.system_hook(12)

46
47
48
# File 'lib/gitlab/client/system_hooks.rb', line 46

def hook(id)
  get("/hooks/#{id}")
end

#hooks(options = {}) ⇒ Array<Gitlab::ObjectifiedHash> Also known as: system_hooks

Gets a list of system hooks.

Examples:

Gitlab.hooks
Gitlab.system_hooks

Options Hash (options):

  • :page (Integer)

    The page number.

  • :per_page (Integer)

    The number of results per page.


17
18
19
# File 'lib/gitlab/client/system_hooks.rb', line 17

def hooks(options = {})
  get('/hooks', query: options)
end