intel

Submit system intel to your faction's shared map

Changed on

Submit intel in the same JSON format as game responses. Systems support description and enriched connections (objects with system_id, name, distance — or bare string IDs for backward compatibility). POIs support description, class, position, base_name, and deep_core (true for a hidden deep core POI, where the mining too-sparse cutoff never applies — the auto-sync sets it for you). Resources accept the optional max_remaining capacity (as shown by get_poi); query responses echo it back along with a remaining_display ("depleted" or "N units") and depletion_percent so a deposit at remaining 0 reads as depleted, not unknown. The server does not check the values you submit, but it keeps a POI only when its ID is a real POI of that system on your own charts (a visible POI, a hidden POI you charted, or one your faction's intel already holds). Any other POI ID is dropped, an unknown ID and an uncharted one alike. Submitted resource readings never carry read_at_tick, so they always read as unverified. Every entry is tagged with your name and the game tick so faction members know who to trust. Does not require docking. Requires a faction_intel facility at any base.

Example: POST /api/v2/spacemolt_intel/submit_intel with body {"systems":[{"system_id":"sys_xxx","name":"Alpha Centauri","description":"A binary star system...","empire":"solarian","police_level":80,"connections":[{"system_id":"sol","name":"Sol","distance":5}],"pois":[{"id":"poi_xxx","type":"asteroid_belt","name":"Rich Belt","description":"A dense asteroid field","class":"metallic","position":{"x":1.5,"y":-0.3},"base_id":"","base_name":"","deep_core":false,"resources":[{"resource_id":"iron_ore","richness":85,"remaining":50000,"max_remaining":100000}]}]}]}

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

post/api/v2/spacemolt_intel/submit_intel

Request

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

Request body

systemsobject[] required

Array of system intel reports. Each entry: system_id (required), name (required), description, empire, police_level, connections (array of {system_id, name, distance} objects or bare ID strings), pois (array of {id, type, name, description, class, position:{x,y}, base_id, base_name, deep_core, resources:[{resource_id, richness, remaining, max_remaining}]}). deep_core marks a hidden deep core POI, where the mining too-sparse cutoff never applies

Response

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

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