API Reference

Datasets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create a new dataset (admin only)

datasets.create(DatasetCreateParams**kwargs) -> Dataset

POST/api/v1/datasets

Create a new dataset (admin only)

ParametersExpand Collapse

name: str

Dataset name

slug: str

URL-friendly slug

attribution: Optional[str]

Attribution text

description: Optional[str]

Dataset description

license: Optional[str]

License identifier

source_url: Optional[str]

Source data URL

ReturnsExpand Collapse

class Dataset: …

id: str

Dataset ID

formatuuid

inserted_at: datetime

Creation timestamp

formatdate-time

name: str

Dataset name

slug: str

URL-friendly slug

updated_at: datetime

Last update timestamp

formatdate-time

attribution: Optional[str]

Attribution text

description: Optional[str]

Dataset description

license: Optional[str]

License identifier

source_url: Optional[str]

Source data URL

Create a new dataset (admin only)

Python

HTTP

TypeScript

Python

Java

Kotlin

Go

Ruby

CLI Tool

PHP

C#

import os
from plaza import Plaza

client = Plaza(
    api_key=os.environ.get("PLAZA_API_KEY"),  # This is the default and can be omitted
)
dataset = client.datasets.create(
    name="name",
    slug="slug",
)
print(dataset.id)

200 example

{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "inserted_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "slug": "slug",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "attribution": "attribution",
  "description": "description",
  "license": "license",
  "source_url": "source_url"
}

Returns Examples

200 example

{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "inserted_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "slug": "slug",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "attribution": "attribution",
  "description": "description",
  "license": "license",
  "source_url": "source_url"
}