---
title: "overlane github installations"
description: "List the team's GitHub App installations and any request waiting for an organization owner"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.overlane.app/llms.txt
> Use this file to discover all available pages before exploring further.

# overlane github installations

{/* Generated by apps/docs/scripts/generate.mjs (CLI pages from the command registry in packages/cli). Do not edit; run `pnpm --filter @overlane/docs gen`. */}

Lists the GitHub accounts where the Overlane GitHub App is installed and verified for this team, with the account type and whether GitHub has suspended the installation. Also lists requests an organization member made that an organization owner has not approved yet. Any role may read it.

## Usage

```sh
overlane github installations [--service URL] [--team TENANT_ID]
```

## Flags

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--service` | string | no |  | The service address (default: OVERLANE_SERVICE_URL, then the project's binding, then the hosted service) |
| `--team` | string | no |  | The team (tenant) to act on (default: the one your token belongs to) |

## Examples

```sh
overlane github installations
overlane github installations --json
```

## Behavior

- Effect: `read` (changes nothing).
- Needs credentials: yes. Uses the network: yes.
- Supports `--dry-run`: no. Accepts `--force`: no.
- Machine-readable description: `overlane schema github installations`.

## Result

With `--json` (the default when stdout is not a terminal) the command prints this JSON Schema's shape on stdout.

```json
{
  "type": "object",
  "properties": {
    "installations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "installationId": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "account": {
            "type": "string",
            "minLength": 1
          },
          "accountType": {
            "type": "string",
            "enum": [
              "User",
              "Organization"
            ]
          },
          "suspended": {
            "type": "boolean"
          }
        },
        "required": [
          "installationId",
          "account",
          "accountType",
          "suspended"
        ],
        "additionalProperties": false
      }
    },
    "waiting": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "requestedBy": {
            "type": "string"
          },
          "requestedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
          }
        },
        "required": [
          "requestedBy",
          "requestedAt"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "installations",
    "waiting"
  ],
  "additionalProperties": false
}
```

See [exit codes](/cli/#exit-codes) for the status the process returns.

Source: https://docs.overlane.app/cli/github-installations/index.mdx