Skip to main content
For the complete documentation index, see llms.txt.
Use Import on the Maneuvers page at /maneuvers/burn-plan to add records produced by external tools. To create or edit a record manually, see Managing Maneuvers.

​
Import OCM files

  1. Open Maneuvers and click Import.
  2. Choose the target spacecraft when needed. Otherwise, VALAR resolves it from file metadata.
  3. Upload one or more CCSDS OCM files (.ocm or .txt).
  4. Review any validation or spacecraft-resolution messages, then import.
  5. Check each file’s result. Successfully imported records appear in the maneuver list; adjust the spacecraft and time filters to find them.
Import adds records without changing other records. Each file is atomic: if any record in a file fails, that file adds nothing. Other successful files remain saved. Retry only failed files after correcting their errors.

​
File requirements

  • OCM KVN format (CCSDS 502.0-B-3), maximum 52 MB per file and per complete multipart request.
  • At least one maneuver block with an identity and valid burn segments.
  • Nonzero thrust vector (THR_X, THR_Y, THR_Z), THR_ISP between 50 and 10,000 seconds, and a physical properties block containing WET_MASS.
  • Valid epochs, positive segment durations, and supported reference frames.
  • Maneuver IDs without reserved characters (! * ' ( ) ; : @ & = + $ , / ? # [ ]).
  • Spacecraft metadata consistent with the target spacecraft.
  • No overlapping enclosing maneuver intervals within the file or with stored records on the same spacecraft. Adjacent intervals may touch at an endpoint.
MAN_BASIS is optional format metadata. It is not a required classification and does not change import behavior. See OCM import requirements for field, unit, reference-frame, and metadata details.

​
Resolve duplicate identities and overlaps

A file whose MAN_ID already exists for that spacecraft is rejected. In the application, open the record and select Edit to change it manually. Renaming a stored record changes its label, not its stable identity or exported MAN_ID. For an API correction, prepare corrected OCM, explicitly delete the stored record, then import the corrected file. See Correct a stored maneuver. These are separate operations: import does not overwrite a record, and a failed import does not undo the deletion. All import validation still applies. If an imported record overlaps an existing one, use the reported identities to inspect the conflict. Decide which record to edit or delete before retrying. VALAR does not remove or shorten existing records to make room. Conflicts can involve records outside the current list window.

​
Automate imports

Use POST /operations/maneuvers/import, repeating the multipart files part for multiple files. Supply the VALAR spacecraftId when the target needs to be explicit. See the Maneuver API guide for authentication, request examples, preview binding, and 200/207/error handling.

​
Troubleshooting