SoulFire LogoSoulFire

Execute command

Executes a command string within the specified scope. The command is parsed and executed using the Brigadier command dispatcher. Permission requirements depend on the scope: - Global scope: Requires GLOBAL_COMMAND_EXECUTION permission - Instance scope: Requires INSTANCE_COMMAND_EXECUTION for the instance - Bot scope: Requires INSTANCE_COMMAND_EXECUTION for the parent instance

POST
/v1/commands:execute

Executes a command string within the specified scope. The command is parsed and executed using the Brigadier command dispatcher.

Permission requirements depend on the scope:

  • Global scope: Requires GLOBAL_COMMAND_EXECUTION permission
  • Instance scope: Requires INSTANCE_COMMAND_EXECUTION for the instance
  • Bot scope: Requires INSTANCE_COMMAND_EXECUTION for the parent instance

Authorization

AuthorizationBearer <token>

Preferred API authentication. Use a JWT with the api audience.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "http://127.0.0.1:38765/v1/commands:execute" \  -H "Content-Type: application/json" \  -d '{    "command": ""  }'
{
  "code": 0
}
{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}
{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}
{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}

How is this page?

Update self username PATCH

Updates the username of the currently authenticated user. The change is persisted to the database immediately.

Complete command POST

Retrieves tab-completion suggestions for a partial command. Uses Brigadier's completion system to generate context-aware suggestions based on the command structure and current cursor position. Permission requirements depend on the scope (same as ExecuteCommand).