STstacklok
plugins

Get plugin details

Changed on

Get detailed information about a specific plugin

get/api/v1beta/plugins/{name}

Request

Path parameters

namestring required

Plugin name

Query parameters

scope'user' | 'project'

Filter by scope (user or project)

project_rootstring

Project root path for project-scoped plugins

Response

OK

project_scope_degraded_clientsstring[]

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

trust_unrecordedboolean

TrustUnrecorded reports that the project's lock file has an entry for this plugin which records neither a signer identity nor an unsigned exception — an entry written before verification existed, or hand-edited. It exists to keep that state distinguishable from having no lock entry at all, which leaves Provenance and Unsigned equally empty: sync reports this one as drift and can repair it, so Info must not render it as if nothing were pinning the plugin.

unmaterialized_componentsobject

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.

unsignedboolean

Unsigned reports that the lock file records an explicit unsigned exception for this plugin.

Changes

  • 022455c26a63Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • a7011540b058Revision changes
    • info

      added the optional property / to the response with the status