---
title: "Get plugin details"
method: GET
path: "/api/v1beta/plugins/{name}"
tags: ["plugins"]
---

# Get plugin details

`GET /api/v1beta/plugins/{name}`

Get detailed information about a specific plugin

## Path parameters

- `name` string, required

## Query parameters

- `scope` 'user' | 'project'
- `project_root` string

## Response `200`

OK

- GithubComStacklokToolhivePkgPluginsPluginInfo
  - `installed_plugin` GithubComStacklokToolhivePkgPluginsInstalledPlugin — InstalledPlugin contains the full installation record.
    - `clients` string[] — Clients is the list of client identifiers the plugin is installed for.
    - `components` GithubComStacklokToolhivePkgPluginsComponentInventory — Components is the inventory of component types declared by the plugin (e.g. {"commands": 3, "skills": 2}). Extracted from the OCI artifact.
    - `dependencies` GithubComStacklokToolhivePkgPluginsDependency[] — Dependencies is the list of external plugin dependencies.
      - `digest` string — Digest is the OCI digest for upgrade detection.
      - `name` string — Name is the dependency name.
      - `reference` string — Reference is the OCI reference for the dependency.
    - `digest` string — Digest is the OCI digest (sha256:...) for upgrade detection.
    - `installed_at` string — InstalledAt is the timestamp when the plugin was installed.
    - `metadata` GithubComStacklokToolhivePkgPluginsPluginMetadata — Metadata contains the plugin's metadata.
      - `author` string — Author is the plugin author or maintainer.
      - `description` string — Description is a human-readable description of the plugin.
      - `keywords` string[] — Keywords is a list of keywords for categorization/search.
      - `license` string — License is the SPDX license identifier for the plugin.
      - `name` string — Name is the unique name of the plugin (kebab-case).
      - `version` string — Version is the semantic version of the plugin.
    - `project_root` string — ProjectRoot is the project root path for project-scoped plugins. Empty for user-scoped.
    - `reference` string — Reference is the full OCI reference (e.g. ghcr.io/org/plugin:v1).
    - `scope` 'user' | 'project' — Scope for the installation
    - `signature` string — Signature is the optional signing signature for the plugin artifact.
    - `status` 'installed' | 'pending' | 'failed' — Status is the current installation status.
    - `tag` string — Tag is the OCI tag (e.g. v1.0.0).
  - `metadata` GithubComStacklokToolhivePkgPluginsPluginMetadata — Metadata contains the plugin's metadata.
    - `author` string — Author is the plugin author or maintainer.
    - `description` string — Description is a human-readable description of the plugin.
    - `keywords` string[] — Keywords is a list of keywords for categorization/search.
    - `license` string — License is the SPDX license identifier for the plugin.
    - `name` string — Name is the unique name of the plugin (kebab-case).
    - `version` string — Version is the semantic version of the plugin.
  - `project_scope_degraded_clients` string[] — ProjectScopeDegradedClients lists the client types for which a project-scoped install degraded (the adapter could only materialize at user scope — e.g. Codex always writes to the user-scoped config.toml). Populated by Info; empty for user-scoped installs. Recomputed at read time from the stored scope + each adapter's capability, mirroring the UnmaterializedComponents pattern (no persistence needed — the degradation is deterministic from scope + client type).
  - `unmaterialized_components` object — UnmaterializedComponents lists, per client type, the component types the plugin declares that the installed client adapter does NOT load. Populated by Info by diffing InstalledPlugin.Components against each installed client adapter's SupportedComponents.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/stacklok/apis/toolhive-api.md) · [All operations](https://skmtc.net/stacklok/apis/toolhive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stacklok/toolhive-api/versions/43b22ce40564/schema)