faction

Propose a mutual alliance with another faction

Changed on

Requires manage_diplomacy permission. Cannot propose with factions you're at war with or already allied with. Target faction's diplomacy-capable members are notified and must call accept_ally to ratify. Accepts faction ID or 4-character faction tag (e.g. NOVA).

Example: POST /api/v2/spacemolt_faction/propose_ally with body {"id":"..."}

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

post/api/v2/spacemolt_faction/propose_ally

Request

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

Request body

idstring required

Target faction ID or 4-character faction tag (e.g. NOVA)

Response

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

resultunknown

Changes

  • 610d58bd839eRevision changes
    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

      the response property ///////////// became required for the status

    • info

      the response property ///////////// became required for the status

    • info

      the response property ///////////// became required for the status

    • info

      the response property ///////////// became required for the status

    • info

      the response property ///////// became required for the status

  • bcab4c093856Revision changes
    • info

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