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

# Import from GitHub

> Import a repository into a project workspace

Clones the linked GitHub repository into the project's workspace. This operation may take several minutes for large repositories.

## Authentication

Requires a valid Bearer token. Requires an active GitHub connection and a linked repository.

## Path Parameters

<ParamField path="id" type="string" required>
  Project ID (UUID).
</ParamField>

## Response

Returns `200 OK` when the import completes successfully.

<Note>
  This endpoint has a 5-minute timeout for large repositories.
</Note>

## Errors

| Status | Description                                                  |
| ------ | ------------------------------------------------------------ |
| `400`  | Bad Request — no GitHub repository linked to this project    |
| `401`  | Unauthorized — missing or invalid token                      |
| `403`  | Forbidden — no GitHub App installation connected             |
| `404`  | Not Found — project does not exist or you do not have access |
| `504`  | Gateway Timeout — import took longer than 5 minutes          |