## List the repositories of a project (tenant:forge:read)

`GET /api/forge/v1/projects/{key}/repositories`

Module: Forge · operationId: `listForgeRepositories` · Tag: Repositories · Auth: access token (`Authorization: Bearer <accessToken>`)

Requires `tenant:forge:read` and a project the caller sees. The default repository comes first.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `key` | path | string | yes | Project key (e.g. APP) |

### Responses

- **200** Repositories (`application/json`)
- **404** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of Repository, required)
  - `createdAt` (string (date-time), required): When it was linked
  - `fullName` (string, required): owner/name
  - `id` (string (uuid), required): Repository link id
  - `isDefault` (boolean, required): The default repository of the project
  - `provider` (string, required): Repository provider key: github, gitlab or gitlab@<host> (self-managed GitLab)
  - `baseBranch` (string, nullable): Base branch for new branches; null = the repository's default branch

Example 200 answer:

```json
{
  "items": [
    {
      "baseBranch": null,
      "createdAt": "2026-09-23T09:10:00Z",
      "fullName": "mbcomdev/demo-app",
      "id": "4b5c6d7e-8f9a-4b1c-8d2e-3f4a5b6c7d01",
      "isDefault": true,
      "provider": "github"
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/forge/v1/projects/string/repositories' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
