Editing SimTX API/Station endpoints (section)

== Launching a satellite ==
<code>POST /api/v1/satellites</code>

<syntaxhighlight lang="json">
{
  "name": "SimSat-1",
  "callsign": "SSAT1",
  "visibility": "PUBLIC",
  "orbit": {
    "model": "simtx-j2-v1",
    "semiMajorAxisKm": 6921.0, "eccentricity": 0.001, "inclinationDeg": 97.6,
    "raanDeg": 120.0, "argumentOfPerigeeDeg": 90.0, "meanAnomalyDeg": 10.0
  },
  "attitude": { "mode": "NADIR", "yawDeg": 0.0 },
  "antennas": [ { "name": "70 cm turnstile", "type": "TURNSTILE" } ],
  "rigs": [ { "name": "Beacon", "paMaxWatts": 2.0, "noiseFigureDb": 2.0 } ]
}
</syntaxhighlight>

* <code>name</code>, <code>callsign</code>, <code>orbit</code> and 1 to 4 antennas are required; up to 8 rigs.
* The orbit is sent without <code>epoch</code>. The account service sets the epoch to the launch instant and interprets the elements at that instant.
* The orbit must pass [[SimTX API/Satellites#Validation|validation]]: model <code>simtx-j2-v1</code>, perigee at least 200 km and apogee at most 40,000 km above the 6,371 km sphere, 0 ≤ ''e'' < 1, 0 ≤ ''i'' ≤ 180°, finite angles, spin rate 0 to 60 rpm.
* Satellite antennas are modelled in free space; their NEC decks must not contain a <code>GN</code> card.
* After launch the satellite is '''sealed''': only <code>name</code>, <code>callsign</code>, <code>visibility</code> and <code>limits</code> can change. Changes to the orbit, attitude, antennas or rigs are refused with <code>409 station_sealed</code>.