Create a time series
create_time_seriesCreate a time series (rain gauge, hydrograph, tide/stage) in a project.
POSTs /projects//time-series/ with series_type and units as
top-level fields. series_type is checked against the four choices and
data against the {"rowData": [{timestamp, value}, ...]} shape before any
request is made — the API answers 500 (not 400) to a malformed row.
Returns a compact record — id, name, series_type, units, timezone,
row_count, http_status — not the echoed rows; fetch the full row with the
REST API (GET /projects//time-series//) if you need to round-trip it.
A rainfall polygon references its gauge by the series NAME, so create the
gauges with the exact names the rainfall GeoJSON's features carry.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The rows: {"rowData": [{"timestamp": "1998-08-17T00:00:00", "value": 1.5}, ...]}. Timestamps ISO 8601 (a trailing Z is tolerated), values numeric. Validated here before anything is sent. | |
| name | Yes | Series name, kept VERBATIM — a rainfall polygon binds to its gauge by this exact name (its `data` property), so use the name the GeoJSON features carry | |
| units | No | Display label for the values, e.g. 'mm/hr', 'm^3/s', 'm' (optional) | |
| source | No | Where the data came from, e.g. a gauge id or agency (optional) | |
| timezone | No | IANA timezone of the timestamps (default 'UTC'), e.g. 'Australia/Sydney' | UTC |
| project_id | Yes | The project ID | |
| description | No | Free-text description (optional) | |
| series_type | No | One of hyetograph (rainfall depth/intensity — the default), hydrograph (flow, read by the Hydrographs panel and inflow boundaries), stage (water level, e.g. a tide) or generic. Sent as a top-level field. | hyetograph |
| location_name | No | Human-readable location of the gauge (optional) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||