Sign in
latestOpenAPI 3.1.02026-08-105279262.8 KB

51f7c5a8d15d

aoiMonitors

Create AOI Monitor

Creates a new AOI monitor for an AOI. The monitor will check for imagery that matches the specified criteria (sources, resolution, cloud cover, etc.).

post/earthcache/aoi-monitors

Request body

namestring required

Display name for the monitor.

descriptionstring

Optional description.

run_mode'auto' | 'manual'

"auto" runs on a schedule; "manual" requires explicit triggering. Defaults to "manual".

start_datestring date required

Start of the monitoring period (ISO 8601 date, e.g. "2024-01-01").

end_datestring date required

End of the monitoring period (ISO 8601 date, e.g. "2024-12-31").

max_cloud_covernumber

Maximum acceptable cloud cover percentage (0–100).

min_aoi_coveragenumber

Minimum required AOI coverage percentage (0–100).

notify_usersstring[]

User IDs to notify when new imagery is found. MUA accounts only.

sourcesstring[]

Satellite data sources to monitor.

min_resolutionnumber

Minimum resolution filter in meters per pixel.

max_resolutionnumber

Maximum resolution filter in meters per pixel.

project_idstring

Project ID to associate with this monitor. MUA accounts only.

sensor_typestring[]

Sensor type filter.

off_nadir_anglenumber[]

[min, max] off-nadir angle range in degrees. The first value must be strictly less than the second.

Example request

{
  "sources": [
    "sentinel-2",
    "landsat"
  ],
  "sensor_type": [
    "optical",
    "sar"
  ]
}

Response

AOI monitor created successfully.

idstring uuid required

Unique monitor identifier.

namestring required

Display name for the monitor.

descriptionstring nullable

Optional description.

run_mode'auto' | 'manual' required

"auto" runs the monitor on a recurring schedule; "manual" requires explicit triggering.

start_datestring date required

Start of the monitoring period (ISO 8601 date).

end_datestring date required

End of the monitoring period (ISO 8601 date).

last_run_timestring date-time nullable

Timestamp of the last monitor run.

max_cloud_covernumber nullable

Maximum acceptable cloud cover percentage (0–100).

min_aoi_coveragenumber nullable

Minimum required AOI coverage percentage (0–100).

notify_usersstring[] nullable

User IDs to notify when new imagery is found. MUA accounts only.

sourcesstring[] nullable

Satellite data sources to monitor.

min_resolutionnumber nullable

Minimum resolution filter in meters per pixel.

max_resolutionnumber nullable

Maximum resolution filter in meters per pixel.

off_nadir_anglenumber[] nullable

[min, max] off-nadir angle range in degrees. The first value must be less than the second.

project_idstring nullable

Associated project ID. MUA accounts only.

org_idstring nullable

Organization identifier.

user_idstring required

ID of the user who created the monitor.

sensor_typestring[] nullable

Sensor type filter.

originstring nullable

Origin identifier for the monitor.

created_atstring date-time nullable

Creation timestamp (ISO 8601).

updated_atstring date-time nullable

Last update timestamp (ISO 8601).

Example response

{
  "sources": [
    "sentinel-2",
    "landsat"
  ],
  "sensor_type": [
    "optical",
    "sar"
  ]
}