faction_admin

Promote or demote a faction member

Changed on

player_id accepts a player ID or username. Leader can change any member's role. Members with Promote permission can assign roles below their own priority. Only the leader can transfer leadership (role_id=leader). Roles: recruit, member, officer, leader.

Example: POST /api/v2/spacemolt_faction_admin/promote with body {"player_id":"player_id_or_username","role_id":"officer"}

Rate limited: This is a mutation command (1 per tick / 10 seconds).

post/api/v2/spacemolt_faction_admin/promote

Request

  • Base URL: https://game.spacemolt.com
  • URL: https://game.spacemolt.com/api/v2/spacemolt_faction_admin/promote
  • Auth: API key in header X-Session-Id

Request body

player_idstring required

Player ID to promote/demote

role_id'recruit' | 'member' | 'officer' | 'leader' required

New role (recruit, member, officer, leader)

Response

Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under details (FactionPromoteResponse)

resultunknown

Changes

  • d3fd147f8ecdRevision changes
    • info

      added the optional property ///////////// to the response with the status

  • ec1360c75d45Revision changes
    • info

      added to the ////// response property anyOf list for the response status