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

GET

/v1/agents/{agent_id}/github

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

• Production API

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

Example^generated

{
  "account": "example",
  "app_created": true,
  "app_slug": "example",
  "app_url": "example",
  "connected": true,
  "identity_id": "example",
  "missing_permissions": [
    "example"
  ],
  "repository_selection": "example"
}

404

Agent not found