# Start GitHub connection

`POST /v1/organizations/{organization}/connections/github/start`, operation `connections.StartGitHubConnection`

Starts connecting GitHub: returns where the caller installs kosem's GitHub App, and the state that GitHub sends back.

GitHub sends the person back to the console with a code, which CompleteGitHubConnection takes with the state, within 30 minutes.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `organization` | path | Yes | `string` | The organization's ID. |

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `authorizeUri` | `string` | Yes | Where the person authorizes kosem's GitHub App without installing it, to connect an installation of it that exists and that they manage; GitHub then sends them to GitHubCallback, as from installUri. |
| `installUri` | `string` | Yes | Where the person installs kosem's GitHub App, on an account and the repositories they choose. GitHub then sends them, with a code and state, to GitHubCallback, which connects the installation and goes on to the console. |
| `state` | `string` | Yes | Ties the installation to this organization and this person, for 30 minutes, which it names, signed; installUri and authorizeUri carry it. It starts with the organization's ID. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.