# GitHubInstallation

> The GitHubInstallation object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `id` * | string |  |
| `workspace_id` * | string |  |
| `installation_id` * | integer |  |
| `account` * | object |  |
| `repository_selection` | `all`, `selected` |  |
| `suspended` | boolean |  |
| `created_at` * | string (date-time) |  |

\* always present

## Example

```json
{
  "id": "ghi_01jbx2m9k7q4r8t5v6w3y0z1pr",
  "workspace_id": "string",
  "installation_id": 1,
  "account": {
    "login": "string",
    "type": "User",
    "avatar_url": "string"
  },
  "repository_selection": "all",
  "suspended": false,
  "created_at": "2026-10-22T13:05:00Z"
}
```

## Used by

- [Connect an installation after the GitHub redirect](/docs/api/git-hub/#connect-an-installation-after-the-github-redirect)
