Access Tokens
Access Rules
Queries
Apps
Attributes
Authentication
- POSTAuthenticate a user based on a Stytch session token (B2B version)
- POSTRegister a user based on a Stytch session token (B2B)
- POSTReport whether the user associatd to a Stytch OAuth or Magic Links token has been fully registered on Narrative side (B2B)
- POSTAuthenticate a user based on a Stytch session token
- POSTRegister a user based on a Stytch session token
- POSTReport whether the user associatd to a Stytch OAuth or Magic Links token has been fully registered on Narrative side
Connections
Datasets
- GETGet datasets
- PUTUpdate a dataset
- POSTCreate a dataset
- GETGet a dataset
- PUTUpdate a dataset
- DELDelete a dataset
- PUTActivate a dataset
- POSTActivate a datasetdeprecated
- POSTTruncate a dataset
- GETSample a dataset
- DELDelete a sample
- GETGet admin info for a dataset
- GETSample a dataset (Admin)
- POSTUpdate a dataset's partition spec
- POSTPreview snapshot expirations
- PUTUpsert retention policies for a dataset
- POSTRequest Dataset Sample
- GETSampled Mappings
- POSTSuggest mappings
- GETGet dataset statistics
- GETGet detailed statistics
- PUTCreate or Update detailed statistics
- POSTSubmit recalculation
- POSTIngest a file
- GETFiles added
- GETFind snapshots
- GETMetrics
- GETMetrics
- GETGet Metrics Configuration
- PUTPut Metrics Configuration
- DELDisable configuration
- PUTDerive the configuration
- POSTEnable configuration
- GETFind files
- POSTIssue file download url
- PUTUpdate the materialized view refresh configuration
- POSTCreate a refresh schedule for an existing materialized view
- DELArchive the materialized view refresh configuration
- POSTRun a materialized view refresh now
Subscriptions
- GETGet subscriptions
- POSTCreate a subscription
- GETGet cost forecasts
- POSTCreate a cost forecast
- GETGet a cost forecast
- POSTGet matches
- GETGet a subscription
- PUTUpdate a subscription
- DELDelete a subscription
- POSTActivate a subscription
- POSTCancel a subscription
- POSTCheckout a subscription
- GETGet subscription cost forecasts
- POSTCreate a cost forecast for a subscription
- GETGet deliveries
- POSTGet a delivered file
- GETGet subscription matches
- GETGet schema
Data Shops
Data Streams
- POSTCreate a data-stream.
- GETGet a data-stream by its id.
- PUTUpdate a data-stream.
- POSTFetch many data-streams
- GETGet all data-streams for a company.
- GETGet all data-streams for a company given a search expression.
- GETGets the data-stream for a given company and slug.
- GETGet schema
- GETGet all data-streams for the given company and its data-shop hostname.
- GETFind data-streams for the given company and its data-shop hostname and the given search expression.
- GETGet all data-streams for a company given a sales channel
- GETFind data-streams for the given company and a sales-channel and the given search expression.
- GETFind data-streams available on the data-streams-market.
Encryption Materials
Schema Inference
Installations
Profiles
Company
Company Marketing Information
Mappings
Model Inference
Payment Methods
Schema Presets
Uploads
Destinations
Products
Permissions
Contracts
Whoami
Webhooks
Ingest a file
Copy
curl --request POST \
--url https://api-dev.narrative.io/datasets/{dataset_id}/upload \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source_file": "/2021-12-01/example.csv"
}
'Datasets
Ingest a file
After uploading a file to Narrative via the upload API, you can then have the file can then be ingested into a dataset.
Related guides:
- How do I create a dataset?: see the section titled Upload Files for Ingestion.
POST
/
datasets
/
{dataset_id}
/
upload
Ingest a file
Copy
curl --request POST \
--url https://api-dev.narrative.io/datasets/{dataset_id}/upload \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source_file": "/2021-12-01/example.csv"
}
'Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Unique identifier for a dataset.
Body
application/json
The file to be ingested.
This must be equal to the upload_path passed to the upload API when the file was submitted to Narrative.
Response
200
OK
⌘I