---
title: "List Unlinked"
method: POST
path: "/api/v1/installations/unlinked"
tags: ["Installations"]
---

# List Unlinked

`POST /api/v1/installations/unlinked`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v1/installations/unlinked`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Retrieves all unlinked repositories available through VCS installations

## Request body

- object
  - `organizationId` string, required: Organization ID to list repositories for

## Response `200`

List of unlinked repositories available through VCS installations

- UnlinkedRepository[]
  - `type` 'github' | 'gitlab', required: Discriminator field to identify the type of repository
  - `repositoryUrl` string, uri, required: Full URL to the repository in the VCS provider
  - `repositoryName` string, required: Display name of the repository
  - `defaultBranch` string, nullable, required: Default branch of the repository; null when the VCS reports none (empty repository)
  - `details` union, required
    - UnlinkedGithubRepository: Github repository available through an installation but not yet linked
      - `githubAppInstallationId` string, required: Installation ID of the Github App
      - `externalGithubRepositoryId` string, required: Github's internal repository identifier
      - `externalGithubAppInstallationId` string, required: Github's internal installation identifier for this specific repository
      - `externalGithubAppId` string, required: Github App ID
    - UnlinkedGitlabRepository: Gitlab repository available through an installation but not yet linked
      - `gitlabInstallationId` string, required: Installation ID for the Gitlab connection
      - `externalGitlabProjectId` string, required: Gitlab's internal project identifier

---

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