Update Dataset Metadata
const url = 'https://example.com/datasets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = { method: 'PATCH', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"summary":"Revised from the 2026 authoritative release.","title":"Updated flood zones","visibility":"public"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://example.com/datasets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "summary": "Revised from the 2026 authoritative release.", "title": "Updated flood zones", "visibility": "public" }'Update user-editable dataset metadata.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”Request Bodyrequired
Section titled “ Request Bodyrequired ”Partial-update payload for dataset metadata.
The class name remains DatasetMeta for generated-SDK compatibility;
new backend call sites use the DatasetMetaUpdate alias below.
object
Responses
Section titled “ Responses ”Successful Response
object
Parent catalog record UUID
Internal PostGIS table name
True when the underlying column is generic GEOMETRY (created sketch datasets): the dataset accepts ANY geometry subtype on write regardless of the display geometry_type above. Computed on the detail endpoint only; list endpoints always report false.
Describes a single column in a dataset’s attribute table.
Automated quality assessment results.
object
Keep only the rows from the last days days, judged by column.
object
A date or timestamp column of the dataset’s table. Rows where it is null are kept.
Monotonic version counter
Healthy, missing, inaccessible, or unknown. ‘unknown’ means never probed, or an origin kind with nothing to probe.
None, drifted, or unknown. Set at refresh commit from the schema diff; ‘unknown’ until a refresh has run.
Fresh, due, overdue, or unknown, computed from last_refreshed_at against the declared update_frequency: due past one declared period, overdue past two. ‘unknown’ when the origin cannot be refreshed at all (created), when no cadence is declared (asNeeded, irregular, notPlanned, unknown), or when nothing has been refreshed yet. Advisory only; never blocks an operation. Distinct from the quality score’s own freshness, which measures quality_detail.computed_at rather than the source.
Access level: private, restricted, internal, public
Minimal reference to a collection a dataset belongs to.
object
Lifecycle status. Deliberately not pinned to an enum: the values come from the workflow extension’s status_order(), so an overlay may define its own. Community default order: draft, ready, internal, published.
Provenance for an analysis output: what it came from, and how.
params stays untyped on purpose: it is the operation’s own parameter
dictionary, so its keys differ by operation. It is also redacted for each
requester: dataset ids that the caller cannot access are omitted.
object
The dataset this one was derived from
Analysis operation that produced it
Operation parameters, minus any dataset reference the requester cannot access
object
Record type: ‘vector_dataset’ (spatial features), ‘raster_dataset’ (single COG), ‘vrt_dataset’ (VRT mosaic), ‘table’ (non-spatial tabular), ‘map’ (saved map), ‘service’ (catalogued remote service), ‘collection’ (flat dataset group), ‘tiles3d_dataset’ (3D Tiles tileset), ‘pointcloud_dataset’ (COPC point cloud).
object
A 3D Tiles dataset’s published tileset.
object
URL path of the tileset’s tileset.json on the app origin, e.g. /api/datasets/{id}/tiles3d/tileset.json
A COPC point cloud’s published file.
The data a replacement or restore replaced, kept until the next one.
Example
{ "has_generic_geometry": false, "current_version": 1, "source_health": "unknown", "schema_drift_status": "unknown", "source_freshness": "unknown", "record_status": "draft", "record_type": "vector_dataset", "raster": { "bands": [] }, "tileset": { "bounding_volume": "region" }}Bad request — invalid payload
Unauthorized — missing or invalid credentials
Forbidden — caller lacks write access
Not found
Conflict — resource state prevents the operation
Validation error
Too many requests — retry after the advertised interval
Headers
Section titled “ Headers ”Seconds until the request may be retried
Internal server error
Service unavailable — the database could not serve the request