v44

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0575177316.0 KB
plugins

Get plugin details

Get detailed information about a specific plugin

get/api/v1beta/plugins/{name}

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

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.