# List the apps this server can connect to

GET

/v1/connection-entries

```sh
curl --request GET \
  --url https://example.com/v1/connection-entries \
  --header 'Authorization: Bearer <token>'
```

Each app with who may own a connection to it, how a person signs in, the permissions a tool may ask for (in plain words, and whether each changes anything) and the guide an admin follows to register the app. Any signed-in member. Mounted when the deployment supplies a `ConnectionBinding`.

## Authorizations

- **[bearerAuth](https://docs.kindgi.com/v0.2.0/reference/api.md#bearerauth)**

## Responses

### 200

The apps.

application/json

object

**data**

required

Array\<object>

An app this server can connect to.

object

**id**

required

The entry id: `'google'`, `'github'`.

string

**name**

required

The app’s name as people know it.

string

**owners**

required

Who may own a connection to this app.

Array\<string>

Allowed values: member company

**signIn**

required

How a person signs in at the app.

object

**kind**

required

string

Allowed values: oauth2 github-app

**tenant**

Present when the sign-in happens in a directory of the app’s own (Microsoft’s tenant, not a Kindgi tenant). A registration’s `oauth2.tenant` names it; without `default`, each registration must give its own.

object

**default**

The directory a registration that names none signs in at.

string

**permissions**

required

What a tool may ask for, by permission key (`gmail.send`).

object

**_key_**

additional properties

object

**says**

required

In plain words, for the person asked.

string

**changes**

required

Whether it changes anything at the app. `false` is read only.

boolean

**removal**

How a disconnect withdraws access at the app, and how the app reports a removal made there. `{}` when the app has neither: a disconnect then withdraws nothing at the app, and a removal made there is not reported.

object

**revoke**

How a disconnect withdraws access at the app: an OAuth revoke, or revoking the GitHub App’s installation tokens (the app stays installed).

string

Allowed values: oauth2-revoke github-installation-token

**revokeIsGrantWide**

Whether the app’s revoke withdraws everything the person granted the registration, not only this connection’s permissions. Google’s does.

boolean

**notices**

How the app reports a removal made at the app.

string

Allowed values: google-risc github-webhooks

**setupGuide**

required

The docs page an admin follows to register the app.

string

##### Example

```json
{
  "data": [
    {
      "owners": [
        "member"
      ],
      "signIn": {
        "kind": "oauth2"
      },
      "removal": {
        "revoke": "oauth2-revoke",
        "notices": "google-risc"
      }
    }
  ]
}
```

### 401

Missing / malformed / expired / revoked bearer token.

application/json

object

**error**

required

object

**code**

required

Stable machine-readable discriminant. Values match domain error codes (see `docs/API-ROUTE-CONVENTIONS.md` §4.3).

string

**message**

required

string

**details**

Optional, kind-specific.

object

**_key_**

additional properties

any

**requestId**

required

Server-assigned request id; also echoed via `X-Request-Id` header.

string

##### Examplegenerated

```json
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}
```

## See also

- [Kindgi 0.2.0](https://docs.kindgi.com/v0.2.0/releases/0.2.0.md)
- [Every error code](https://docs.kindgi.com/v0.2.0/reference/errors.md)