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

# List linked repositories

> 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.



## OpenAPI

````yaml /openapi.json get /v1/linked-repositories
openapi: 3.0.3
info:
  title: CodeRabbit API spec
  version: 1.0.0
servers:
  - url: https://api.coderabbit.ai
security:
  - ApiKeyAuth: []
paths:
  /v1/linked-repositories:
    get:
      tags:
        - Repositories
      summary: List linked repositories
      description: >-
        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.
      operationId: linked-repositories-list
      parameters:
        - in: query
          name: repository_ids
          description: Provider repository IDs, comma-separated or repeated.
          schema:
            type: array
            items:
              type: string
          style: form
          explode: false
          example: 12345,67890
        - in: query
          name: organization_ids
          description: CodeRabbit organization UUIDs, comma-separated or repeated.
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: form
          explode: false
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
        - in: query
          name: cursor
          description: >-
            Pagination cursor from the previous response. Keep filters and limit
            unchanged.
          schema:
            type: string
      responses:
        '200':
          description: >-
            Linked repository graph page. GET
            /linked-repositories?repository_ids=12345&limit=50 selects one
            source repository.
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - next_cursor
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      required:
                        - repository
                        - linked_repositories
                      properties:
                        repository:
                          type: object
                          required:
                            - id
                            - name
                            - organization_id
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            organization_id:
                              type: string
                              format: uuid
                        linked_repositories:
                          type: array
                          items:
                            type: object
                            required:
                              - id
                              - name
                              - organization_id
                              - type
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                              organization_id:
                                type: string
                                format: uuid
                              type:
                                type: string
                                enum:
                                  - MANUAL
                                  - AUTO
                  next_cursor:
                    type: string
                    nullable: true
              example:
                data:
                  - repository:
                      id: '12345'
                      name: acme/api
                      organization_id: 550e8400-e29b-41d4-a716-446655440000
                    linked_repositories:
                      - id: '67890'
                        name: acme/shared
                        organization_id: 550e8400-e29b-41d4-a716-446655440000
                        type: MANUAL
                next_cursor: null
        '400':
          description: Invalid filters or pagination cursor.
        '401':
          description: Invalid API key or missing user context.
        '403':
          description: >-
            Enterprise, rollout, CodeRabbit administrator, key type, or
            permission requirement not met.
        '410':
          description: Legacy organization API key.
        '429':
          description: Rate limit exceeded.
        '500':
          description: Internal server error.
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-coderabbitai-api-key
      description: >-
        API key for authentication. You can create an API key from the
        CodeRabbit dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.