---
title: "List the plugins that install on a project"
method: GET
path: "/api/v1/plugins"
tags: ["Management"]
---

# List the plugins that install on a project

`GET /api/v1/plugins`

## 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`
- Auth: none declared

Core's plugin catalog, in its display order. With project_id it adds the unlisted plugins the project owns or has installed, and requires canManagePlugins on the project.

## Query parameters

- `project_id` string

## Response `200`

Project plugins

- object
  - `plugins` object[], required
    - `slug` string, required
    - `name` string, required
    - `description` string
    - `logo_url` string, required: A path without a host is on the web app's origin.
    - `permissions` object[], required
      - `resource` string, required
      - `access` string, required
      - `description` string, required: The permission as an installer reads it.
    - `installable_project_id` string: The only project that can install the plugin. Absent when any project can.
    - `install_url` string: Where Install sends a customer, so the plugin starts the install from its own side. Absent means install in Entire.

## 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-16** `886f7c6b0b79`: 1 info
  - added the optional property `plugins/items/install_url` to the response with the `200` status
- **2026-10-14** `932485b2df18`: 2 info
  - added the new optional `query` request parameter `project_id`
  - added the optional property `plugins/items/installable_project_id` to the response with the `200` status
- **2026-10-08** `d755dd67ad29`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/plugins/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)