DataIngestion

Datasources

Inspect and manage the output of ingestion.
View as Markdown

A datasource is the result of ingestion.

It represents source data after it has been read, validated, and prepared by the platform. Onboarding uses datasources as the input for creating datasets.

Initial and incremental datasources

The first successful ingestion job creates an initial datasource.

Later ingestion jobs can create incremental datasources that build on the original datasource. Incremental datasources keep a reference to their parent datasource and include an increment_index and increment_label so updates can be traced over time.

Retrieve datasources

Retrieve datasources when you need to find the datasource created by an ingestion job or select a datasource for onboarding.

GET
/datasources
1curl https://api.hi.umnai.com/datasources \
2     -H "Authorization: Bearer <token>"
Response
1{
2  "data": [
3    {
4      "id": "ea8b745ead39ec442fc3b4fba359bf98",
5      "name": "Sample Organisation",
6      "status": "ACTIVE",
7      "created_at": "2026-03-11T16:04:19.749000Z",
8      "updated_at": null
9    }
10  ],
11  "pagination": {
12    "total_items": 1,
13    "items_per_page": 10,
14    "current_page": 1,
15    "total_pages": 1
16  }
17}

You can filter the list by data_processing_job_id when you want the datasource produced by a specific ingestion job.

Retrieve a datasource

Retrieve a datasource by id when you need to inspect a specific datasource before onboarding.

GET
/datasources/:datasourceId
1curl https://api.hi.umnai.com/datasources/{datasourceId} \
2     -H "Authorization: Bearer <token>"
Response
1{
2  "data": [
3    {
4      "id": "ea8b745ead39ec442fc3b4fba359bf98",
5      "name": "Sample Organisation",
6      "status": "ACTIVE",
7      "created_at": "2026-03-11T16:04:19.749000Z",
8      "updated_at": null
9    }
10  ],
11  "pagination": {
12    "total_items": 1,
13    "items_per_page": 10,
14    "current_page": 1,
15    "total_pages": 1
16  }
17}

Update a datasource

Update a datasource when you need to rename it.

PATCH
/datasources/:datasourceId
1curl -X PATCH https://api.hi.umnai.com/datasources/datasourceId \
2     -H "Authorization: Bearer <token>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "name": "Sample Datasource"
6}'
Response
1{
2  "id": "1ea7e575defdf6bc3f26a3f127e98170",
3  "name": "Sample Datasource",
4  "increment_index": 0,
5  "increment_label": "initial",
6  "account": {
7    "id": "e268443e43d93dab7ebef303bbe9642f",
8    "name": "Sample Account"
9  },
10  "data_processing_job": {
11    "id": "fa895821d8f17f02c48bd90f4c98f4bd",
12    "name": "Sample Ingestion Job"
13  },
14  "status": "AVAILABLE",
15  "created_at": "2026-03-14T15:37:07.205784Z",
16  "parent_datasource": null,
17  "created_by": {
18    "id": "dad46b2058752ffde5eaf02f1eb6abd5",
19    "name": "Sample User"
20  },
21  "updated_at": "2026-03-14T15:42:12.273038Z",
22  "tags": []
23}

Delete a datasource

Delete a datasource when it should no longer be used.

DELETE
/datasources/:datasourceId
1curl -X DELETE https://api.hi.umnai.com/datasources/datasourceId \
2     -H "Authorization: Bearer <token>"

Views

Datasource views help inspect the structure and lineage of ingested data.

  • Lineage shows how a datasource was created and how it evolved across ingestion runs.
  • Histogram shows the distribution of values in a datasource.