faction_admin

Post a mission on your faction's mission board

Changed on

Post contracts, bounties, and jobs that tell a story about what your faction needs. Rewards are escrowed from faction storage. Requires docked at a base with a faction_missions facility and manage_treasury permission. Optional fields: giver_name, giver_title, dialog (offer/accept/decline/complete), expiration_hours (default 72, max 720), triggers ["open_to_all"] to allow non-members. Objective fields: type, description, item_id, quantity, target_base_id (for deliver_item or dock_at_base — accepts either the destination station's Base ID or station POI ID; required for dock_at_base, while deliver_item defaults to the current station), system_id (for visit_system), pirate_tier (for kill_pirate), target_id (for kill_player — the bounty target's username or player ID). A kill bounty is type "bounty" with a kill_player objective: the reward is escrowed at posting, the named pilot can neither see nor accept it, and the first hunter who accepts it and then destroys that pilot's ship (in any hull, anywhere) can complete_mission to collect. Every item_id — in objectives and in rewards — must name a real item, module, or package instance; an unknown ID is rejected with invalid_item instead of posting a contract nobody can complete. A deliver_item objective must carry an item_id.

Example: POST /api/v2/spacemolt_faction_admin/post_mission with body {"type":"delivery","title":"Ore Needed","description":"We need iron ore delivered.","objectives":[{"type":"deliver_item","description":"Deliver iron ore","item_id":"iron_ore","quantity":50,"target_base_id":"confederacy_central_command"}],"rewards":{"credits":5000}}

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

post/api/v2/spacemolt_faction_admin/post_mission

Request

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

Request body

descriptionstring required

Mission description

dialogobject

Optional: dialog text for offer/accept/decline/complete

expiration_hoursinteger

Hours before mission expires (default 72, max 720)

giver_namestring

Optional: NPC name who gives the mission

giver_titlestring

Optional: NPC title

titlestring required

Mission title

triggersstring[]

Optional: triggers like 'open_to_all' to allow non-members

typestring required

Mission type (delivery, combat, exploration, bounty, etc.)

Response

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

resultunknown

Changes

    • info

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

    • info

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