Get Plugin

GET /{namespace}/{principalType}/{principalId}/plugins/{pluginId}

Return the exact authorized canonical plugin through the query service, including its strong etag and public declaration. Credentials are never expanded by this item read.

Required scope

Any authenticated access token

Path parameters

namespacestringRequired: Resource namespace
principalTypestringRequired: Principal type
principalIdstringRequired: Principal identifier
pluginIdstringRequired: Plugin resource identifier

Returns

200

Canonical plugin resource

Fields

Plugin

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

Invalid plugin identifier

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

401 UNAUTHORIZED

Authentication is required

Obtain a valid access token, then retry.

404 NOT_FOUND

No authorized plugin has this identity

Verify the target identifier and that its endpoint or plugin route still exists.

500 INTERNAL

The plugin query failed

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