Skip to content

Dataset

A Dataset is a Product of curated Things of one Noun, with a promise that they are true.

Properties

PropertyTypeRequiredDescription
recordsintegerHow many Things it holds.
refreshedAtdatetimeWhen its Sources were last read.
Inherited from Product: 3 properties
PropertyTypeRequiredDescription
namestringrequiredThe name of the Product.
promisetextrequiredWhat the Customer can rely on.
statusstringrequiredOne of draft, selling or retired, set by its Offers.

Object

JSON
{
  "$id": "https://api.sb/tutorloop.com/datasets/dataset_1",
  "$type": "Dataset",
  "name": "TutorLoop",
  "promise": "A tutor confirmed within one hour.",
  "status": "draft",
  "records": 1,
  "refreshedAt": "2026-10-22T12:00:00Z"
}

Relationships

  • A Dataset curates one Noun: a Dataset collects and vouches for the Things of exactly one Noun. curates, inverse curatedIn.

Verbs

  1. createCreates a Dataset.
    POST /{namespace}/datasetsdoDataset.created
  2. getReturns one Dataset by id.
    GET /{namespace}/datasets/{id}readNo Event
  3. listReturns Datasets, newest first, one page at a time.
    GET /{namespace}/datasetsreadNo Event
  4. updateChanges the given properties of a Dataset.
    PATCH /{namespace}/datasets/{id}doDataset.updated
  5. deleteDeletes a Dataset; its history is kept.
    DELETE /{namespace}/datasets/{id}doDataset.deleted

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Dataset.createYesYesYesNo
Dataset.getYesYesYesYes
Dataset.listYesYesYesYes
Dataset.updateYesYesYesNo
Dataset.deleteYesYesYesNo

Call it

Text
Add a dataset to QuietCopy.

Example

A Dataset of 4.2 million business registrations across 50 states refreshes nightly. It promises each record matches the state filing as of its refreshedAt.