List Plugins

GET /plugins

Lists all available plugins

Requires a signed user/session or the existing authenticated client flow. The anonymous DCR delegated device profile cannot invoke this operation.

Required scope

Any authenticated access token

Query parameters

expandarray<PluginExpansion>

Space-delimited unique projection tokens. metadata expands the public provider declaration; oauth.clientSecret requests the protected OAuth credential projection under its existing authorization rules. Omit this parameter for the default catalog representation.

uniqueItems: true

idstring

Full path ID of a specific plugin to retrieve (e.g. port1/systems/zero/plugins/{uuid})

nextTokenstring

Opaque token for the next page of results. Pass the continuation token returned by the previous response, unchanged. Omit it to start from the first page.

maxResultsinteger

Maximum number of results to return.

minimum: 1

maximum: 100

Returns

200

Plugins retrieved successfully

Fields

EnumeratePluginsResponse

Response headers

ETagstring: Opaque strong entity tag of the returned resource version. Send it back in `If-Match` on the next mutation of the same resource.

Errors

400 BAD_REQUEST

Unknown, repeated or malformed query parameter, out-of-range page size, or unsupported expansion token.

Check the request fields and any validation details, then correct the payload.

500 INTERNAL

Internal server error

Retry with backoff only when the operation is safe to repeat. Include the error code when reporting persistent failures.