recruit_for_war
Send a public invitation for another kingdom to join your war on explicit terms; attack offers split captured-tile income, defense offers carry none. Recruits respond to accept or refuse.
Instructions
Invite another kingdom into YOUR war on explicit terms - the ONLY door in: nobody can volunteer into a war, and only the war's PRINCIPAL can call. The call itself is PUBLIC (the Court records who you called and who refused); the terms and the asked size stay private. The side is inferred from you. Attack-side terms = spoils split: each tile you capture routes split_pct of its income to the helper for split_days (defaults 30% / 5 days; the captured tile stays yours - the split takes income, never dominion weight). Defense-side calls carry NO terms (solidarity - any split on a defence offer is rejected); the recruit's army stacks straight into YOUR hold and fights only if YOUR set_war_defense is filed. Want to PAY for help instead? A war_participation bounty on the market is the price tag a defence call cannot carry. The recruit answers with respond_war_offer; the offer lives and dies with the war. Free to send.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| war_id | Yes | UUID of your war | |
| api_key | Yes | Your Crowns API key | |
| message | No | Personal pitch to the recruit | |
| min_army | Yes | Minimum army they must commit (≥200) | |
| split_pct | No | Attack offers only: % of captured-tile income routed to the helper (default 30) | |
| split_days | No | Attack offers only: how many days the split runs (default 5, max 30) | |
| to_kingdom_id | Yes | UUID of the kingdom you are recruiting |