Skip to content
Plaza Plaza Docs
GuidesBlogPlaygroundDashboard
API Reference
Datasets

Create a new dataset (admin only)

Dataset Datasets.Create(DatasetCreateParamsparameters, CancellationTokencancellationToken = default)
POST/api/v1/datasets

Create a new dataset (admin only)

ParametersExpand Collapse
DatasetCreateParams parameters
required string name

Human-readable dataset name

required string slug

URL-friendly identifier (lowercase, hyphens, no spaces)

string? attribution

Required attribution text

string? description

Dataset description

string? license

License identifier (e.g. CC-BY-4.0)

string? sourceUrl

Source data URL

formaturi
ReturnsExpand Collapse
class Dataset:

Metadata for a custom dataset. Datasets contain user-uploaded geospatial features separate from the OSM data.

required string ID

Dataset UUID

formatuuid
required DateTimeOffset InsertedAt

Creation timestamp (UTC)

formatdate-time
required string Name

Human-readable dataset name

required string Slug

URL-friendly identifier

required DateTimeOffset UpdatedAt

Last update timestamp (UTC)

formatdate-time
string? Attribution

Required attribution text

string? Description

Dataset description

string? License

License identifier (e.g. CC-BY-4.0)

string? SourceUrl

URL of the original data source

formaturi

Create a new dataset (admin only)

DatasetCreateParams parameters = new()
{
    Name = "NYC Bike Lanes",
    Slug = "nyc-bike-lanes",
};

var dataset = await client.Datasets.Create(parameters);

Console.WriteLine(dataset);
{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "inserted_at": "2019-12-27T18:11:19.117Z",
  "name": "NYC Bike Lanes",
  "slug": "nyc-bike-lanes",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "attribution": "attribution",
  "description": "description",
  "license": "license",
  "source_url": "https://example.com"
}
Returns Examples
{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "inserted_at": "2019-12-27T18:11:19.117Z",
  "name": "NYC Bike Lanes",
  "slug": "nyc-bike-lanes",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "attribution": "attribution",
  "description": "description",
  "license": "license",
  "source_url": "https://example.com"
}