# Connect a repository

`POST /v1/repos`

**In this build:** Uses a stand-in for an external service. The record is real. Cloning needs a connected GitHub App.

**Scope:** `environment.write`

**CLI:** `harebox repo add`

## Request: `SelectRepoRequest`

| Field | Type | Notes |
|---|---|---|
| `full_name` (required) | `string` |  |
| `setup_script` | `string` |  |
| `path` | `string` |  |

## Response: 201

`Repo`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `full_name` (required) | `string` |  |
| `setup_script` | `string or null` |  |
| `path` | `string` |  |

Errors follow [one format](../errors.html).