# List the org's Everruns GitHub App links

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Identity & access](https://everruns.com/docs/api/groups/identity-access/)/List the org's Everruns GitHub App links

# List the org's Everruns GitHub App links

Preview

List the organization’s links to the shared Everruns GitHub App.

Public APIEverruns Cloud and self-hosted Platform

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

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

## Parameters

### Path Parameters

**org**

required

string

## Responses

200

### 200

Media typeapplication/json

The org’s links to the shared Everruns GitHub App.

object

**app_slug**

The shared App’s slug; agents that choose it show up as `<slug>[bot]`.

string | null

**configured**

required

The deployment has a shared App; without one nothing can be linked.

boolean

**installations**

required

Array\<object>

One shared App installation linked to the org.

object

**account**

required

GitHub account the installation is on.

string

**account_type**

GitHub’s account type: `User` or `Organization`.

string | null

**agent_count**

required

Agents in the org acting through this link.

integer

**id**

required

Connection id agents choose the link by.

string format: uuid

**installation_id**

required

GitHub installation id.

integer format: int64

**linked_at**

required

string format: date-time

**repository_selection**

`all` or `selected`.

string | null

### Example

```json
{
  "installations": [
    {
      "account": "acme",
      "installation_id": 4242
    }
  ]
}
```

403Admin access required

### 403

Admin access required

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/orgs/example/github/everruns-app';
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
```

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

200403

200 ·

```json
{
  "configured": true,
  "installations": [
    {
      "account": "acme",
      "agent_count": 0,
      "id": "string",
      "installation_id": 4242,
      "linked_at": "2026-10-12T09:00:00Z"
    }
  ]
}
```

403 · Admin access required

No response body example is declared for this status.

## Matching endpoints