Create or update the Github integration

PUT

/api/v4/projects/{id}/integrations/github

• GitLab REST API

Creates or updates the Github integration.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project

Example

1

Request Body ^required

Media type application/json

object

token

required

GitHub API token with repo:status OAuth scope.

string

nullable

repository_url

required

GitHub repository URL.

string

nullable

static_context

Append the hostname of your GitLab instance to the status check name.

boolean

nullable

pipeline_events

Trigger event when a pipeline status changes.

boolean

nullable

use_inherited_settings

Indicates whether to inherit the default settings. Defaults to false.

boolean

nullable

Example ^generated

{
  "token": "example",
  "repository_url": "example",
  "static_context": true,
  "pipeline_events": true,
  "use_inherited_settings": true
}

Responses

200

OK

Media type application/json

object

id

integer format: int64

title

string

slug

string

created_at

string format: date-time

updated_at

string format: date-time

active

boolean

commit_events

boolean

push_events

boolean

issues_events

boolean

incident_events

boolean

alert_events

boolean

confidential_issues_events

boolean

merge_requests_events

boolean

tag_push_events

boolean

deployment_events

boolean

note_events

boolean

confidential_note_events

boolean

pipeline_events

boolean

wiki_page_events

boolean

job_events

boolean

comment_on_event_enabled

boolean

inherited

boolean

vulnerability_events

boolean

Example

{
  "id": 75,
  "title": "Jenkins CI",
  "slug": "jenkins",
  "created_at": "2019-11-20T11:20:25.297Z",
  "updated_at": "2019-11-20T12:24:37.498Z"
}

400

Bad request

401

Unauthorized

404

Not found

422

Unprocessable entity