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

# Update Propagation Forces

`PATCH /propagations/{id}/forces`

Update force models to propagation job.

## Path parameters

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

## Query parameters

- `group_id` string, uuid, nullable — Optional group ID to use for the request

## Request body

- BodyUpdatePropagationForcesPropagationsIdForcesPatch
  - `force_models` PropagationForceModels, required
    - `earth_model` EarthModel
      - `model` string — Physical characteristics of Earth as described by an Earth Model. Currently supports: "WGS84", "GRS80", "EGM96"
    - `geopotential` Geopotential
      - `active` boolean — Set to True to enable force model in propagation.
      - `degree` integer, nullable — The degree of geopotential effect to use.
      - `order` integer, nullable — The order of geopotential effect to use.
    - `third_bodies` ThirdBodies
      - `active` boolean — Set to True to enable force model in propagation.
      - `celestial_bodies` CelestialBody[], nullable — List of celestial third body force models. Currently supported: "SUN","EARTH", "MOON", "MERCURY", "VENUS", "MARS", "JUPITER", "SATURN", "URANUS", "NEPTUNE"
    - `drag` Drag
      - `active` boolean — Set to True to enable force model in propagation.
      - `atmospheric_model` 'HARRISPRIESTER' | 'JB2008' | 'NRLMSISE00' — Supported atmospheric models for drag force.
    - `ocean_tides` OceanTides
      - `active` boolean — Set to True to enable force model in propagation.
      - `degree` integer, nullable — The degree of OceanTides effect to use.
      - `order` integer, nullable — The order of OceanTides effect to use.
    - `solid_tides` SolidTides
      - `active` boolean — Set to True to enable force model in propagation.
    - `solar_radiation_pressure` SolarRadiationPressure
      - `active` boolean — Set to True to enable force model in propagation.

## Response `201`

Successful Response

- 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

## 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)