# GitHub

### Configure GitHub integration

To create integration between Brainboard and GitHub:

1. Go to the [Git integration](https://app.brainboard.co/settings/integrations/git) settings page.
2. Click on `Integrations`
3. Click on  `Connect with GitHub`

<figure><img src="/files/D7cmVTUWu3yzKhzrsT84" alt=""><figcaption></figcaption></figure>

You'll be redirected to the GitHub website, where you can choose the organization for which you want to configure access:&#x20;

<figure><img src="/files/Y6mDlyR3wm4op7GJyKE9" alt=""><figcaption></figcaption></figure>

After selecting the organization, you are prompted to specify the repositories:&#x20;

**N.B:** Brainboard requires `read-write` access to be able to do pull requests.

<figure><img src="/files/OqzQU207ijDwE9z4oQCl" alt=""><figcaption></figcaption></figure>

After selecting the repositories, you'll be automatically redirected to Brainboard Git app settings page. Now the button should have changed to `View GitHub integration`. &#x20;

{% hint style="info" %}
Brainboard Enterprise SSO users: If your organization uses Brainboard Enterprise SSO for authentication, the redirection to Brainboard app will fail after selecting the repositories. In this case, please contact our support to update your GitHub `installation_id`.
{% endhint %}

Once the connection is configured successfully, it will be you should it with a green indication

<figure><img src="/files/HqlhCH4jwpqZ4wD45JEM" alt=""><figcaption></figcaption></figure>

### Enable personal connection

1. Once the GitHub app integration is done you need to click on `Add connection` in `Personal connections` section. This will open the settings where you can allow Brainboard to do pull requests on your behalf by clicking on `Connect with Github`<br>

   <figure><img src="/files/1Z6HISseWq28orqH8X5e" alt=""><figcaption></figcaption></figure>

   If the Git app integration is not configured, Brainboard will display a warning as it has to be done first<br>

   <figure><img src="/files/R2aCMbDeKrdF7lQK3Kug" alt=""><figcaption></figcaption></figure>
2. The GitHub website will open in a new tab, asking you to authorize Brainboard app to access your GitHub account. Click on the `Authorize Brainboard` button:

   ![Github authorize](/files/TvElJARWT23U0aeGp3iR)
3. You will then be redirected to Brainboard personal git tokens page, with a confirmation that the GitHub connection was successful:

   ![Github\_connection\_success](/files/jKWvqmUOaVEcG5lnA27j)

### Edit GitHub integration

To edit the GitHub integration:

1. Go to the [Git integration](https://app.brainboard.co/settings/integrations/git) settings page.
2. Click on `Integrations`
3. Click on  `Access GitHub`
4. You'll be redirected to the GitHub website, where you can edit the integration with Brainboard.

### Delete GitHub integration

To delete integration with GitHub:

1. Go to the [Git integration](https://app.brainboard.co/settings/integrations/git) settings page.
2. Click on `Integrations`&#x20;
3. You need to delete your personal connection first by clicking on it in the section `Personal connectio` then click on `Delete configuration`

   <figure><img src="/files/PMp4z3OWTzEKudikOGOG" alt=""><figcaption></figcaption></figure>
4. Go back to the page of Git connections and click on  `Access GitHub`
5. You'll be redirected to the GitHub website, where you can delete the integration with Brainboard.<br>

   <figure><img src="/files/IJn5QNTB7t2tPIniFBBb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The update will be immediate, and you will no longer be able to do pull requests.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.brainboard.co/settings/integrations/git-configuration/github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.