---
title: "Update State Vector"
method: PATCH
path: "/states/{id}"
tags: ["State Vector"]
---

# Update State Vector

`PATCH /states/{id}`

Update state vector to Kayhan's system.<br/>
    Define: State Vector, Coordinate Frame, Epoch.<br/>

## Path parameters

- `id` string, uuid, required

## Request body

- FullSpacecraftState
  - `pos` Vector3, required — 3-dimensional physical quantity
    - `x` number, required — The first element of the vector
    - `y` number, required — The second element of the vector
    - `z` number, required — The third element of the vector
    - `unit` string, nullable — The unit of the vector
  - `vel` Vector3, required — 3-dimensional physical quantity
    - `x` number, required — The first element of the vector
    - `y` number, required — The second element of the vector
    - `z` number, required — The third element of the vector
    - `unit` string, nullable — The unit of the vector
  - `timestamp` string, required — The timestamp of the state vector
  - `ref_frame` 'EME2000' | 'EME2000' | 'TEME' | 'GCRF' | 'CIRF' | 'ICRF' | 'TIRF' | 'ITRF' | 'ITRF_2014' | 'ITRF_2008' | 'ITRF_2005' | 'ITRF_2000' | 'ITRF_97' | 'ITRF_96' | 'ITRF_94' | 'ITRF_93' | 'ITRF_92' | 'ITRF_91' | 'ITRF_90' | 'ITRF_89' | 'ITRF_88' | 'ITRFEQUINOX' | 'MOD' | 'TOD' | 'GTOD' | 'EFG' | 'VEIS1950' | 'RIC' | 'PTW' | 'TNW' | 'VNB' | 'LVLH' | 'ENCOUNTER' | 'ENU' | 'SEZ' | 'CUSTOM', required
  - `covariance_matrix` CovarianceMatrix
    - `data` number[], required
    - `ref_frame` 'EME2000' | 'EME2000' | 'TEME' | 'GCRF' | 'CIRF' | 'ICRF' | 'TIRF' | 'ITRF' | 'ITRF_2014' | 'ITRF_2008' | 'ITRF_2005' | 'ITRF_2000' | 'ITRF_97' | 'ITRF_96' | 'ITRF_94' | 'ITRF_93' | 'ITRF_92' | 'ITRF_91' | 'ITRF_90' | 'ITRF_89' | 'ITRF_88' | 'ITRFEQUINOX' | 'MOD' | 'TOD' | 'GTOD' | 'EFG' | 'VEIS1950' | 'RIC' | 'PTW' | 'TNW' | 'VNB' | 'LVLH' | 'ENCOUNTER' | 'ENU' | 'SEZ' | 'CUSTOM', required
    - `length_unit` string, required
    - `format` 'LT' | 'LT' | 'LT' | 'SQUARE' | 'SQUARE', required
  - `spacecraft_parameters` Spacecraft, required
    - `mass` number, nullable — Mass of the Spacecraft, specified in kg
    - `coeff_drag` number, nullable — Coefficient of drag, unitless. Not to be confused with the Ballistic coefficient (coeff_drag * cross_section_area / mass).
    - `coeff_rad` number, nullable — Coefficient of solar radiation pressure, unitless.Not to be confused with the SRP Area / Mass coefficient(coeff_srp * cross_section_area / mass).
    - `area_drag` number, nullable — Effective area of the object exposed to atmospheric drag.Specified in m**2.
    - `area_rad` number, nullable — Effective area of the object exposed to solar radiation pressure.Specified in an area unit, e.g. u.m**2.
  - `object_name` string, nullable — Name of object
  - `norad_cat_id` integer, nullable — NORAD ID of object.

## Response `201`

Successful Response

- 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

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