---
title: "Update Propagation"
method: PATCH
path: "/propagations/{id}"
tags: ["Propagation"]
---

# Update Propagation

`PATCH /propagations/{id}`

Adjust propagation parameters to Kayhan's system and update propagation job.<br/>
    Define: Propagation Duration, and Time Step. By default, only includes Two Body Force Model.

## Path parameters

- `id` string, uuid, required — UUID of Propagation

## Request body

- PropagationJobParameters
  - `start_time` string, date-time, nullable — OPTIONAL: Propagation Start Time in ISOT Format: (Year-Month-DayTHour:Minute:Seconds). Include if start time is different than state vector epoch.
  - `end_time` string, date-time, nullable — OPTIONAL: Propagation Target Time in ISOT Format: (Year-Month-DayTHour:Minute:Seconds). NOTE: Must include either target_time or target_duration.
  - `target_duration` number, nullable — OPTIONAL: Propagation Target Duration in Seconds. NOTE: Must include either end_time or target_duration.
  - `timestep` number, nullable — Propagation Time Step between each reported epoch, in seconds.
  - `purpose` string, nullable — Purpose of propagation (MANUAL or SCREENING)
  - `infer_interval_from_screening` boolean — Whether to allow the time interval of the Propagation to be inferred based on counterpart data assigned to a Screening, if the Propagation is assigned to a Screening. If unsure, leave this enabled.
  - `enable_discontinuities` boolean — Whether maneuver discontinuities are included in the propagated ephemeris. This is only relevant when exporting to an ephemeris format supporting multiple blocks such as CCSDS OEM/OCM.

## Response `201`

Successful Response

- PropagationRead
  - `id` string, uuid, required
  - `created_at` string, date-time, nullable
  - `status` 'CREATED' | 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'CANCELED', required
  - `ephemeris_id` string, uuid, nullable
  - `start_time` string, date-time, nullable
  - `end_time` string, date-time, nullable
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `target_duration` number, nullable
  - `timestep` number, nullable
  - `enable_discontinuities` boolean
  - `maneuver_count` integer
  - `state_vector` StateVectorRead
    - `id` string, uuid, required
    - `norad_id` integer, nullable
    - `object_name` string, nullable
    - `pos_x` number, required
    - `pos_y` number, required
    - `pos_z` number, required
    - `pos_unit` string, required
    - `vel_x` number, required
    - `vel_y` number, required
    - `vel_z` number, required
    - `vel_unit` string, required
    - `timestamp` string, date-time, required
    - `frame` string, required
    - `mass` number, required
    - `coeff_drag` number, nullable
    - `coeff_rad` number, nullable
    - `area_drag` number, nullable
    - `area_rad` number, nullable
    - `covariance` CovarianceMatrixRead
      - `data` number[], required
      - `format` string, required
      - `frame` string, required
      - `length_unit` string, required
  - `forces` ForceModelRead
    - `id` string, uuid, required
    - `earth_model` string, nullable
    - `geopotential` boolean
    - `geopotential_degree` integer, nullable
    - `geopotential_order` integer, nullable
    - `drag` boolean
    - `drag_model` string, nullable
    - `third_bodies` boolean
    - `third_bodies_list` string, nullable
    - `solid_tides` boolean
    - `solar_radiation_pressure` boolean
    - `ocean_tides` boolean
    - `oceantides_degree` integer, nullable
    - `oceantides_order` integer, nullable
  - `maneuvers` ManeuverRead[], nullable
    - `id` string, uuid, required
    - `type` string, required
    - `ignition_epoch` string, date-time, required
    - `delta_mass` number, nullable
    - `ref_frame` string, nullable
    - `deltav_x` number, nullable
    - `deltav_y` number, nullable
    - `deltav_z` number, nullable
    - `deltav_unit` string, nullable
    - `thrust_x` number, nullable
    - `thrust_y` number, nullable
    - `thrust_z` number, nullable
    - `thrust_unit` string, nullable
    - `duration` number, nullable
    - `specific_impulse` number, nullable
    - `rso_id` string, uuid, nullable
  - `tle` TLERead
    - `id` string, uuid, required
    - `object_name` string, nullable
    - `line1` string, nullable
    - `line2` string, nullable
  - `tle_id` string, uuid, nullable
  - `state_vector_id` string, uuid, nullable
  - `rso` RSORead
    - `id` string, uuid, required
    - `norad_id` integer, nullable
    - `international_designator` string, nullable
    - `object_type` string, nullable
    - `object_type_category` string, nullable
    - `object_name` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/satcat/apis/satcat-service-api.md) · [All operations](https://skmtc.net/satcat/apis/satcat-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/satcat/satcat-service-api/versions/afeec2546de3/schema)