Update a pending or active dataset.
All fields can be updated on a pending dataset.
Schema property metadata (sensitive, required, unsellable) and enumeration (append-only), description, display_name
can be updated on an active dataset.
Archived datasets cannot be updated.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Unique identifier for a dataset.
The Dataset's name. Should be unique, contain only alpanum chars and underscores. Max length is 256.
The Dataset's name to display at UI.
A description of the data contained with the dataset.
Schema describing a dataset's input file type and the kind of data the file contains. Note: when the file type is "flat" then the order of the properties describing the must be given in the order they appear in the input file.
Tags that describe the dataset.
How Narrative will treat new data uploaded for the dataset.
append means data will be added to the dataset, this is what to choose if you incrementally update your dataset over time.overwrite means that all existing data will be overwritten with new data.append, overwrite OK
Unique identifier for the dataset.
The ID of the company owning the dataset.
ISO-8601 timestamp indicating when the dataset was created
The Dataset's name. Should be unique, contain only alpanum chars and underscores. Max length is 256.
The Dataset's name to display at UI.
Backwards-compatible legacy payloads. Interpreted as snapshot-level retention on Iceberg. Returned response will be unified v1 shape with compat.mode=legacy.
{ "type": "expire_everything" }Schema describing a dataset's input file type and the kind of data the file contains. Note: when the file type is "flat" then the order of the properties describing the must be given in the order they appear in the input file.
The dataset status.
active means that data can be added to the dataset but the schema is locked in placepending means the dataset has been created, but the schema can still be altered and no data can be added to the datasetactive, pending Tags that describe the dataset.
How Narrative will treat new data uploaded for the dataset.
append means data will be added to the dataset, this is what to choose if you incrementally update your dataset over time.overwrite means that all existing data will be overwritten with new data.append, overwrite ISO-8601 timestamp indicating when the dataset was last updated.
A description of the data contained with the dataset.
Id of a subscription which writes output to the dataset
ISO-8601 timestamp indicating when the last snapshot was created.