---
title: "List the projects the caller can install a project plugin on"
method: GET
path: "/api/v1/plugins/{plugin}/projects"
tags: ["Management"]
---

# List the projects the caller can install a project plugin on

`GET /api/v1/plugins/{plugin}/projects`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/plugins/{plugin}/projects`
- Auth: none declared

Every project the caller may install plugins on (core's canManagePlugins: project manage, or GitHub org owner on a GitHub-sourced project), with its repositories from core.

## Path parameters

- `plugin` string, required

## Response `200`

Projects and their repositories

- object
  - `projects` object[], required
    - `id` string, required
    - `name` string, required
    - `provider` 'github' | 'entire', required: Namespace provider. Reserved GitHub mirror projects use github.
    - `reference` object: Canonical public route identity. Omitted when a provider owner is unresolved.
      - `forge` 'gh' | 'et', required
      - `project` string, required
    - `owner` object, required
      - `type` 'org' | 'account', required
      - `id` string, required
      - `name` string
    - `repositories` object[], required
      - `id` string, required
      - `name` string, required
      - `full_name` string
      - `active` boolean, required: Only an active repo can be selected: core has no repository id for the others.

## Other responses

- `400`: Invalid request
- `401`: Not authenticated
- `403`: Access denied
- `404`: Resource not found
- `409`: Resource conflict
- `412`: Precondition failed
- `422`: Validation failed
- `429`: Too many requests
- `502`: Entire Core request failed
- `503`: Entire Core is unavailable

## Changes

- **2026-10-05** `7311ac3485c3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/plugins/:plugin/projects/get.md)

---

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