Create Empty Dataset Endpoint
const url = 'https://example.com/api/datasets/create/';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"title":"example","columns":[{"name":"example","type":"text"}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/datasets/create/ \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "title": "example", "columns": [ { "name": "example", "type": "text" } ] }'Create an empty dataset with user-defined columns.
Creates a PostGIS table in the data schema and a catalog record.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
object
Responses
Section titled “ Responses ”Successful Response
object
Parent catalog record UUID
Internal PostGIS table name
Describes a single column in a dataset’s attribute table.
Automated quality assessment results.
object
Monotonic version counter
Access level: private, restricted, internal, public
Minimal reference to a collection a dataset belongs to.
object
Lifecycle status: draft, ready, published
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).
object
Example
{ "current_version": 1, "record_status": "draft", "record_type": "vector_dataset", "raster": { "bands": [] }}Bad request — invalid payload
object
Example
{ "type": "about:blank"}Unauthorized — missing or invalid credentials
object
Example
{ "type": "about:blank"}Forbidden — caller lacks write access
object
Example
{ "type": "about:blank"}Not found
object
Example
{ "type": "about:blank"}Conflict — resource state prevents the operation
object
Example
{ "type": "about:blank"}Validation error
object
Example
{ "type": "about:blank"}Internal server error
object
Example
{ "type": "about:blank"}