# Show an agent's own GitHub App: whether it exists, whether it is installed, on which account, and which permissions it lacks.

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

GET

/v1/agents/{agent\_id}/github

Select code samplecURL (shell:curl)

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


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

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

* Production APIapp.everruns.com/api/v1/agents/{agent\_id}/github

## Parameters

### Path Parameters

**agent\_id**

required

string

Prefixed public identifier

## Responses

### 200

Success

Media typeapplication/json

GitHub as seen from an agent’s page.

object

**account**

GitHub account the App is installed on.

string | null

**app\_created**

required

The App exists. Without `connected` it was never installed, or its installation was removed.

boolean

**app\_slug**

string | null

**app\_url**

string | null

**connected**

required

An installation is bound, so tools and triggers work.

boolean

**identity\_id**

The agent’s identity, once it has one; disconnect goes through it.

string | null

**missing\_permissions**

required

Permissions new Apps request that this installation lacks (`name:level`), e.g. `actions:read` for CI triggers on an App created before them. Empty when not connected.

Array\<string>

**repository\_selection**

`all` or `selected`.

string | null

**suggested\_owners**

required

GitHub accounts this organization already reached, as candidates for `owner_org` when creating the App: installation accounts of its GitHub connections and owners of its other agents’ Apps. Organizations first, then users, then accounts of unknown kind; by login within each.

Array\<object>

A GitHub account a new App could be created in.

object

**kind**

required

What kind of GitHub account a login is.

string

Allowed values: organization user unknown

**login**

required

string

##### Example

```json
{
  "suggested_owners": [
    {
      "kind": "organization"
    }
  ]
}
```

### 404

Agent not found