Editing SimTX API/Satellites (section)

== Life cycle ==
{| class="wikitable"
! State !! Meaning
|-
| <code>ACTIVE</code> || Launched and in orbit. Usable for sessions; listed if PUBLIC.
|-
| <code>DEORBITING</code> || The deorbit burn has fired. The satellite is fully usable on its falling orbit until it reenters.
|-
| <code>DEORBITED</code> || Reentered. Sessions are refused with <code>STATION_INACTIVE</code>. The record remains until the owner deletes it.
|}

* '''Launch.''' <code>POST /api/v1/satellites</code> with the name, callsign, visibility, limits, orbit (without epoch), attitude, 1 to 4 antennas and up to 8 rigs. The account service sets the orbit epoch to the launch instant. See [[SimTX API/Station endpoints#Launching a satellite|Station endpoints]].
* '''Sealed.''' After launch only the name, callsign, visibility and limits can change. The orbit, attitude, antennas and rigs cannot; to change them, deorbit the satellite and launch another.
* '''Deorbit.''' A retrograde burn, not a deletion, and it cannot be undone. See [[#Deorbit|Deorbit]].
* '''Antennas''' on satellites are modelled in free space. The circularly polarised types <code>TURNSTILE</code> and <code>HELIX</code> and the <code>MONOPOLE</code> are intended for them; a NEC deck must not contain a <code>GN</code> card.