Get details of all plugins accessible to the requester.

  • Published on Jul 22, 2025
  • 1 minute(s) read
Prev Next
Get
/sys/v1/plugins

Get details of all plugins accessible to the requester.

Security
HTTP
Type bearer
API Key: apiKeyAuth
Header parameter nameAuthorization
Query parameters
ListPluginsParams
group_id
string (uuid)

Group for which the associated plugins should be retrieved.

limit
integer

Maximum number of entries to return.

offset
integer

Starting offset.

OneOf
PluginSortVariantByPluginId
object (PluginSortVariantByPluginId)
sort
string Required
Pattern^plugin_id:(?:asc|desc)$
Exampleplugin_id:asc
start
string (uuid)

Starting offset(UUID of plugin).

Responses
2XX

Success result

Array of object
object
acct_id
string (uuid)

The id of the Account that the plugin belongs to.

created_at
string

Timestamp when the plugin was created.

Pattern^\d{4}\d{2}\d{2}T\d{2}\d{2}\d{2}Z$
Example20170509T070912Z
creator

A security principal.

OneOf
PrincipalVariantApp
object (PrincipalVariantApp)
app
string (uuid)
PrincipalVariantUser
object (PrincipalVariantUser)
user
string (uuid)
PrincipalVariantPlugin
object (PrincipalVariantPlugin)
plugin
string (uuid)
PrincipalVariantUserViaApp
object (PrincipalVariantUserViaApp)
userviaapp
object
user_id
string (uuid)
scopes
Array of string (OauthScope)
string

OAuth scope.

Valid values[ "app", "openid", "email", "profile" ]
string
string
Valid values[ "system" ]
string
string
Valid values[ "unregistereduser" ]
default_group
string (uuid)

The default group a plugin belongs to.

description
string | null

Description of the plugin.

enabled
boolean

Is plugin enabled.

lastrun_at
string

Timestamp when the plugin was most recently used.

Pattern^\d{4}\d{2}\d{2}T\d{2}\d{2}\d{2}Z$
Example20170509T070912Z
lastupdated_at
string

Timestamp when the plugin was most recently updated.

Pattern^\d{4}\d{2}\d{2}T\d{2}\d{2}\d{2}Z$
Example20170509T070912Z
legacy_access
boolean

If a requester is updating/using a Plugin they must have the relevant permissions in all Groups that Plugin has access to. But for legacy Plugins, the requester is required to have relevant permissions in any one of the groups that Plugin has access to.

name
string

Name of the plugin, which must be unique within an account.

Max length4096
Pattern^[^\n]*[^\s\n][^\n]*$
plugin_id
string (uuid)

Unique id to identify a plugin.

plugin_type
string

Type of a plugin.

Valid values[ "STANDARD", "IMPERSONATING", "CUSTOMALGORITHM" ]
source

Plugin code that will be executed inside SGX enclave.

OneOf
object
object
repo_url
string
name
string
version
string
Pattern^\d+.\d+$
language
string

Language of plugin code.

Valid values[ "LUA" ]
code
string
object
object
language
string

Language of plugin code.

Valid values[ "LUA" ]
code
string
groups
Array of string

Set of all the groups that plugin is part of.

string (uuid)