---
title: "List linked repositories"
method: GET
path: "/v1/linked-repositories"
tags: ["Repositories"]
---

# List linked repositories

`GET /v1/linked-repositories`

## Request

- Base URL: `https://api.coderabbit.ai`
- URL: `https://api.coderabbit.ai/v1/linked-repositories`
- Auth: API key in header `x-coderabbitai-api-key`

Lists manual configured candidates derived only from saved UI settings and stored automatic links filtered by saved UI settings. The manual projection approximates saved UI inheritance and overrides and normalizes at most 20 entries per settings layer. This is not a complete manual graph, effective configuration, or a record of review usage. Repository and central YAML-derived links are not read; custom sources and per-review overrides are also unavailable. These sources can change both manual associations and automatic mode. Repository and organization filters select a union of source repositories; omitted or empty filters select the full scope. Targets are resolvable active repositories in the source organization, within the authorized scope. Requires Enterprise, an authenticated CodeRabbit administrator (cr_admin), and both repository management and repository settings read permissions. Organization keys require an organization administrator; workspace keys require a workspace administrator. Self-hosted keys without user context are denied.

## Query parameters

- `repository_ids` string[]
- `organization_ids` string[]
- `limit` integer
- `cursor` string

## Response `200`

Linked repository graph page. GET /linked-repositories?repository_ids=12345&limit=50 selects one source repository.

- object
  - `data` object[], required
    - `repository` object, required
      - `id` string, required
      - `name` string, required
      - `organization_id` string, uuid, required
    - `linked_repositories` object[], required
      - `id` string, required
      - `name` string, required
      - `organization_id` string, uuid, required
      - `type` 'MANUAL' | 'AUTO', required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid filters or pagination cursor.
- `401`: Invalid API key or missing user context.
- `403`: Enterprise, rollout, CodeRabbit administrator, key type, or permission requirement not met.
- `410`: Legacy organization API key.
- `429`: Rate limit exceeded.
- `500`: Internal server error.

## Changes

- **2026-11-06** `a9e20f8748a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coderabbit/apis/coderabbit-api-spec/changes/v1/linked-repositories/get.md)

---

[API](https://skmtc.dev/coderabbit/apis/coderabbit-api-spec.md) - [All operations](https://skmtc.dev/coderabbit/apis/coderabbit-api-spec/llms.txt) - [OpenAPI document](https://skmtc.dev/coderabbit/apis/coderabbit-api-spec/revisions/a9e20f8748a9?raw)