Class: PluginInstanceManager

Manages plugin instances (installations) for a project.

Constructors

new PluginInstanceManager()

new PluginInstanceManager(ctx, projectId): PluginInstanceManager

Internal

Parameters

Parameter	Type
ctx	ClientContext
projectId	string

Returns

PluginInstanceManager

Defined in

4Players/cortex-typescript-sdk/src/resources/plugins.ts:82

Methods

create()

create(body): Promise<object>

Install a plugin for this project

Parameters

Parameter	Type	Description
body	object	Plugin installation payload
body.pluginId	string	Description Plugin ID to activate
body.settings?	object	Description Initial settings

Returns

Promise<object>

Created plugin instance

Name	Type	Description	Defined in
createdAt	string	Format: date-time Description Creation timestamp	4Players/cortex-typescript-sdk/src/types.ts:2328
id	string	Description Instance UUID	4Players/cortex-typescript-sdk/src/types.ts:2311
isEnabled	boolean	Description Whether this instance is enabled	4Players/cortex-typescript-sdk/src/types.ts:2323
pluginId	string	Description Plugin ID	4Players/cortex-typescript-sdk/src/types.ts:2317
projectId?	string	Description Project ID (null = all projects)	4Players/cortex-typescript-sdk/src/types.ts:2315
settings	object	Description User-configured settings	4Players/cortex-typescript-sdk/src/types.ts:2319
tenantId	string	Description Tenant ID	4Players/cortex-typescript-sdk/src/types.ts:2313
updatedAt	string	Format: date-time Description Last update timestamp	4Players/cortex-typescript-sdk/src/types.ts:2333

Defined in

4Players/cortex-typescript-sdk/src/resources/plugins.ts:105

---

delete()

delete(instanceId): Promise<object>

Uninstall a plugin instance

Parameters

Parameter	Type	Description
instanceId	string	Plugin instance ID

Returns

Promise<object>

Deletion confirmation

Name	Type	Description	Defined in
message	string	Description Status message Example Plugin instance deleted	4Players/cortex-typescript-sdk/src/types.ts:2348

Defined in

4Players/cortex-typescript-sdk/src/resources/plugins.ts:148

---

get()

get(instanceId): Promise<object>

Get a plugin instance by ID

Parameters

Parameter	Type	Description
instanceId	string	Plugin instance ID

Returns

Promise<object>

Plugin instance with plugin details

Name	Type	Description	Defined in
createdAt	string	Format: date-time Description Creation timestamp	4Players/cortex-typescript-sdk/src/types.ts:2292
id	string	Description Instance UUID	4Players/cortex-typescript-sdk/src/types.ts:2275
isEnabled	boolean	Description Whether this instance is enabled	4Players/cortex-typescript-sdk/src/types.ts:2287
plugin	object	Description Plugin definition	4Players/cortex-typescript-sdk/src/types.ts:2299
plugin.category	"moderation" | "analytics" | "automation" | "integration"	Description Category	4Players/cortex-typescript-sdk/src/types.ts:2216
plugin.description?	string	Description Description	4Players/cortex-typescript-sdk/src/types.ts:2206
plugin.events	string[]	Description Event patterns Example [ "message.created" ]	4Players/cortex-typescript-sdk/src/types.ts:2223
plugin.icon?	string	Description Heroicons icon name Example heroicons_outline:shield-check	4Players/cortex-typescript-sdk/src/types.ts:2245
plugin.id	string	Description Plugin UUID	4Players/cortex-typescript-sdk/src/types.ts:2194
plugin.isActive	boolean	Description Whether plugin is available	4Players/cortex-typescript-sdk/src/types.ts:2247
plugin.name	string	Description Display name Example Profanity Filter	4Players/cortex-typescript-sdk/src/types.ts:2204
plugin.outputAnnotationType?	"profanity" | "summary" | "action_items" | "sentiment"	Description Output annotation type	4Players/cortex-typescript-sdk/src/types.ts:2228
plugin.pricingUrl?	string	Description Pricing page URL for the tied Payment product, shown in the install cost-acceptance notice. Example https://odin.4players.io/pricing	4Players/cortex-typescript-sdk/src/types.ts:2240
plugin.productSlug?	string	Description Payment product slug this plugin activates (set = paid plugin). When present, installing/enabling the plugin activates this product and disabling/uninstalling deactivates it. Example amanda	4Players/cortex-typescript-sdk/src/types.ts:2235
plugin.settingsSchema?	object[]	Description Settings schema	4Players/cortex-typescript-sdk/src/types.ts:2230
plugin.slug	string	Description URL-friendly identifier Example profanity-filter	4Players/cortex-typescript-sdk/src/types.ts:2199
plugin.version	string	Description Semantic version Example 1.0.0	4Players/cortex-typescript-sdk/src/types.ts:2211
pluginId	string	Description Plugin ID	4Players/cortex-typescript-sdk/src/types.ts:2281
projectId?	string	Description Project ID (null = all projects)	4Players/cortex-typescript-sdk/src/types.ts:2279
settings	object	Description User-configured settings	4Players/cortex-typescript-sdk/src/types.ts:2283
tenantId	string	Description Tenant ID	4Players/cortex-typescript-sdk/src/types.ts:2277
updatedAt	string	Format: date-time Description Last update timestamp	4Players/cortex-typescript-sdk/src/types.ts:2297

Defined in

4Players/cortex-typescript-sdk/src/resources/plugins.ts:119

---

list()

list(): Promise<object[]>

List installed plugin instances

Returns

Promise<object[]>

Array of plugin instances with plugin details

Defined in

4Players/cortex-typescript-sdk/src/resources/plugins.ts:91

---

update()

update(instanceId, body): Promise<object>

Update a plugin instance

Parameters

Parameter	Type	Description
instanceId	string	Plugin instance ID
body	object	Updated settings
body.isEnabled?	boolean	Description Enable/disable the instance
body.settings?	object	Description Updated settings

Returns

Promise<object>

Updated plugin instance

Name	Type	Description	Defined in
createdAt	string	Format: date-time Description Creation timestamp	4Players/cortex-typescript-sdk/src/types.ts:2328
id	string	Description Instance UUID	4Players/cortex-typescript-sdk/src/types.ts:2311
isEnabled	boolean	Description Whether this instance is enabled	4Players/cortex-typescript-sdk/src/types.ts:2323
pluginId	string	Description Plugin ID	4Players/cortex-typescript-sdk/src/types.ts:2317
projectId?	string	Description Project ID (null = all projects)	4Players/cortex-typescript-sdk/src/types.ts:2315
settings	object	Description User-configured settings	4Players/cortex-typescript-sdk/src/types.ts:2319
tenantId	string	Description Tenant ID	4Players/cortex-typescript-sdk/src/types.ts:2313
updatedAt	string	Format: date-time Description Last update timestamp	4Players/cortex-typescript-sdk/src/types.ts:2333

Defined in

4Players/cortex-typescript-sdk/src/resources/plugins.ts:134