---
title: "GitHub organisations this person can add to the workspace"
method: GET
path: "/client/github/reachable"
tags: ["Apps"]
---

# GitHub organisations this person can add to the workspace

`GET /client/github/reachable`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/github/reachable`
- Auth: HTTP bearer

The installations of the Roar app that THIS PERSON’S OWN GitHub login reaches, minus the ones the workspace already holds — including an organisation other workspaces already use. `connected: false` means they have not linked their own GitHub yet (nothing else is offered); `failed: true` means GitHub could not be asked, which is not the same as nothing to add; `canAdd: false` means the workspace’s member-connect policy, or an API key or operator, which have no GitHub login. Says nothing about which other workspaces use an installation. `installUrl` is GitHub’s install flow for an organisation the app is not approved on yet — a non-owner’s click there becomes a request to that organisation’s owners. Requires `apps:read`.

## Response `200`

What can be added, and why the list may be empty. (Response shape not yet modelled in this spec.)

- object

## Other responses

- `403`: Key lacks apps:read

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)