# Link an Everruns GitHub App installation

Source: <https://everruns.com/docs/api/operations/authorize_link/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Identity & access](https://everruns.com/docs/api/groups/identity-access/)/Link an Everruns GitHub App installation

# Link an Everruns GitHub App installation

Preview

Start linking a shared Everruns GitHub App installation to the organization.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/orgs/{org}/github/everruns-app/authorize`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**org**

required

string

### Query Parameters

**return_to**

string

**popup**

boolean

## Responses

303Redirect to GitHub

### 303

Redirect to GitHub

403Admin access required

### 403

Admin access required

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/orgs/example/github/everruns-app/authorize';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/orgs/example/github/everruns-app/authorize
```

Additional language examples require JavaScript. The default request example is available above.

303403

303 · Redirect to GitHub

No response body example is declared for this status.

403 · Admin access required

No response body example is declared for this status.

## Matching endpoints