---
title: "Create Ground Observer"
method: POST
path: "/ground_observers"
tags: ["Mission Planning"]
---

# Create Ground Observer

`POST /ground_observers`

Create a saved ground observer for the request group.

## Query parameters

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

## Request body

- GroundObserverCreate
  - `sensor_id` string, required
  - `name` string, nullable
  - `tags` string[], required
  - `definition` union, required — Observer definition.
    - UDLGroundSensorDefinition
      - `source_type` 'UDL_GROUND_SENSOR'
      - `ground_sensor` UDLGroundSensor, required — Compatible with the UDL GroundSensor model. Can be used for both ground stations and ground sensors such as radar / EO.
        - `sensorName` string, required
        - `idSensor` string, required
        - `source` string, required
        - `classificationMarking` string, required
        - `entity` UDLGroundSensorEntity, required
          - `location` UDLGroundSensorLocation, required
            - `lat` number, required
            - `lon` number, required
            - `altitude` number, required
        - `sensorcharacteristics` UDLSensorCharacteristic[], nullable, required
          - `minRangeLimit` number, nullable
          - `maxRangeLimit` number, nullable
          - `maxSunElevationAngle` number, nullable
        - `sensorlimitsCollection` UDLSensorAzElLimit[], nullable, required
          - `upperLeftAzimuthLimit` number, nullable
          - `upperRightAzimuthLimit` number, nullable
          - `lowerLeftAzimuthLimit` number, nullable
          - `lowerRightAzimuthLimit` number, nullable
          - `upperLeftElevationLimit` number, nullable
          - `upperRightElevationLimit` number, nullable
          - `lowerLeftElevationLimit` number, nullable
          - `lowerRightElevationLimit` number, nullable
    - GroundStationDefinition
      - `source_type` 'GROUND_STATION'
      - `latitude_deg` number, required
      - `longitude_deg` number, required
      - `altitude_m` number, required
      - `min_elevation_deg` number, nullable

## Response `201`

Successful Response

- GroundObserverRead
  - `sensor_id` string, required
  - `name` string, nullable
  - `tags` string[], required
  - `definition` union, required — Observer definition.
    - UDLGroundSensorDefinition
      - `source_type` 'UDL_GROUND_SENSOR'
      - `ground_sensor` UDLGroundSensor, required — Compatible with the UDL GroundSensor model. Can be used for both ground stations and ground sensors such as radar / EO.
        - `sensorName` string, required
        - `idSensor` string, required
        - `source` string, required
        - `classificationMarking` string, required
        - `entity` UDLGroundSensorEntity, required
          - `location` UDLGroundSensorLocation, required
            - `lat` number, required
            - `lon` number, required
            - `altitude` number, required
        - `sensorcharacteristics` UDLSensorCharacteristic[], nullable, required
          - `minRangeLimit` number, nullable
          - `maxRangeLimit` number, nullable
          - `maxSunElevationAngle` number, nullable
        - `sensorlimitsCollection` UDLSensorAzElLimit[], nullable, required
          - `upperLeftAzimuthLimit` number, nullable
          - `upperRightAzimuthLimit` number, nullable
          - `lowerLeftAzimuthLimit` number, nullable
          - `lowerRightAzimuthLimit` number, nullable
          - `upperLeftElevationLimit` number, nullable
          - `upperRightElevationLimit` number, nullable
          - `lowerLeftElevationLimit` number, nullable
          - `lowerRightElevationLimit` number, nullable
    - GroundStationDefinition
      - `source_type` 'GROUND_STATION'
      - `latitude_deg` number, required
      - `longitude_deg` number, required
      - `altitude_m` number, required
      - `min_elevation_deg` number, nullable
  - `id` string, uuid, required
  - `group_id` string, uuid, nullable, required
  - `public` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, 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)