Skip to main content

​
List Plugins

Get all available plugins. Non-admin users only see enabled plugins. 
curl -X GET https://api.stellarstack.io/plugins \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

Returns an array of plugin objects.
​
pluginId
string
Unique plugin identifier
​
name
string
Plugin display name
​
version
string
Plugin version
​
description
string
Plugin description
​
author
string
Plugin author
​
status
string
Plugin status: “installed”, “enabled”, “disabled”, “error”
​
category
string
Plugin category
​
isBuiltIn
boolean
Whether this is an official built-in plugin

​
Get Plugin Details

Retrieve detailed information about a specific plugin. 
curl -X GET https://api.stellarstack.io/plugins/{pluginId} \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID (e.g., “curseforge-installer”)

​
Response

​
pluginId
string
Plugin ID
​
name
string
Plugin name
​
version
string
Current version
​
description
string
Plugin description
​
status
string
Plugin status
​
config
object
Current plugin configuration
​
manifest
object
Full plugin manifest with actions, permissions, etc.
404 Not Found - Plugin not found

​
Get Server Tab Plugins

Get plugins that provide custom tabs for a specific server. 
curl -X GET https://api.stellarstack.io/plugins/server/{serverId}/tabs \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
serverId
string
required
Server ID

​
Response

Returns an array of plugins that provide tabs compatible with the server’s game type. 404 Not Found - Server not found

​
Enable Plugin

Enable a plugin. Admin only. 
curl -X POST https://api.stellarstack.io/plugins/{pluginId}/enable \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID

​
Response

Returns the updated plugin object with status “enabled”. 400 Bad Request - Failed to enable plugin 403 Forbidden - Admin role required

​
Disable Plugin

Disable a plugin. Admin only. 
curl -X POST https://api.stellarstack.io/plugins/{pluginId}/disable \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID

​
Response

Returns the updated plugin object with status “disabled”. 400 Bad Request - Failed to disable plugin 403 Forbidden - Admin role required

​
Update Plugin Configuration

Update a plugin’s configuration settings. Admin only. 
curl -X PATCH https://api.stellarstack.io/plugins/{pluginId}/config \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your-api-key",
    "autoRestart": true
  }'

​
Path Parameters

​
pluginId
string
required
Plugin ID

​
Request Body

Configuration object (schema varies by plugin).

​
Response

Returns the updated plugin object. 400 Bad Request - Failed to update configuration 403 Forbidden - Admin role required

​
Uninstall Plugin

Uninstall a plugin. Only community plugins can be uninstalled. Admin only. 
curl -X DELETE https://api.stellarstack.io/plugins/{pluginId} \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID

​
Response

​
success
boolean
Always true on successful uninstallation
400 Bad Request - Cannot uninstall built-in plugins 403 Forbidden - Admin role required

​
Execute Plugin Action

Execute a plugin action on a server. 
curl -X POST https://api.stellarstack.io/plugins/{pluginId}/actions/{actionId} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serverId": "server-id",
    "inputs": {
      "version": "1.20.4"
    },
    "confirmed": true
  }'

​
Path Parameters

​
pluginId
string
required
Plugin ID
​
actionId
string
required
Action ID from plugin manifest

​
Request Body

​
serverId
string
required
Server ID to execute action on
​
inputs
object
Action input parameters (schema defined by plugin action)
​
confirmed
boolean
Confirmation for dangerous actions (required if action is marked dangerous)

​
Response

​
success
boolean
Whether action executed successfully
​
executedOperations
number
Number of operations completed
​
error
string
Error message if action failed

​
Error Responses

400 Bad Request
​
error
string
Error message
​
requiresConfirmation
boolean
True if action requires confirmation
​
action
object
Action details
403 Forbidden - Access denied to server 404 Not Found - Plugin or action not found

​
Get Plugin Storage

Get a value from plugin storage. Admin only. 
curl -X GET "https://api.stellarstack.io/plugins/{pluginId}/storage/{key}?serverId=server-id" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID
​
key
string
required
Storage key

​
Query Parameters

​
serverId
string
Optional server ID for server-scoped storage

​
Response

​
key
string
Storage key
​
value
any
Stored value

​
Set Plugin Storage

Set a value in plugin storage. Admin only. 
curl -X PUT https://api.stellarstack.io/plugins/{pluginId}/storage/{key} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "value": {"config": "data"},
    "serverId": "server-id"
  }'

​
Path Parameters

​
pluginId
string
required
Plugin ID
​
key
string
required
Storage key

​
Request Body

​
value
any
required
Value to store (any JSON-serializable data)
​
serverId
string
Optional server ID for server-scoped storage

​
Response

​
success
boolean
Always true

​
Get Plugin Statistics

Get usage statistics for a plugin. Admin only. 
curl -X GET "https://api.stellarstack.io/plugins/{pluginId}/stats?days=30" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID

​
Query Parameters

​
days
number
default:"30"
Number of days to analyze (max 365)

​
Response

Returns plugin usage statistics including action counts, success rates, and performance metrics.

​
Query Audit Log

Query the plugin audit log with filters. Admin only. 
curl -X GET "https://api.stellarstack.io/plugins/audit?pluginId=plugin-id&limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Query Parameters

​
pluginId
string
Filter by plugin ID
​
userId
string
Filter by user ID
​
serverId
string
Filter by server ID
​
result
string
Filter by result: “success”, “error”, “denied”
​
limit
number
default:"100"
Maximum number of entries to return
​
offset
number
default:"0"
Number of entries to skip

​
Response

Returns an array of audit log entries.

​
Get Security Analysis

Get security analysis and alerts for a plugin. Admin only. 
curl -X GET https://api.stellarstack.io/plugins/{pluginId}/security \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID

​
Response

​
alerts
array
Array of security alerts and suspicious activity

​
Install Plugin from Git

Install a plugin from a Git repository. Admin only. 
curl -X POST https://api.stellarstack.io/plugins/install \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "repoUrl": "https://github.com/username/plugin-name",
    "branch": "main"
  }'

​
Request Body

​
repoUrl
string
required
Git repository URL
​
branch
string
default:"main"
Branch to install from

​
Response

​
success
boolean
Always true
​
plugin
object
Installed plugin object
​
message
string
Success message
400 Bad Request - Installation failed

​
Update Plugin

Update an installed plugin from its Git repository. Admin only. 
curl -X POST https://api.stellarstack.io/plugins/{pluginId}/update \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID

​
Response

​
success
boolean
Always true
​
plugin
object
Updated plugin object
​
message
string
Success message
400 Bad Request - Update failed

​
Get Security Report

Get the security analysis report for a plugin. Admin only. 
curl -X GET https://api.stellarstack.io/plugins/{pluginId}/security-report \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
pluginId
string
required
Plugin ID

​
Response

​
pluginId
string
Plugin ID
​
name
string
Plugin name
​
trustLevel
string
Trust level: “official” or “community”
​
securityScore
number
Security score (0-100, higher is safer)
​
securityReport
object
Detailed security analysis
​
analyzedAt
string
ISO 8601 timestamp of last analysis
404 Not Found - Plugin not found

Build docs developers (and LLMs) love

Get started for freeTalk to us