POST
/
ingest
/
{namespace}
/
{datasetName}
HttpResponse<String> response = Unirest.post("https://api.datalinks.com/api/v1/ingest/{namespace}/{datasetName}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": [\n    {\n      \"name\": \"Braveheart\",\n      \"year\": 1995,\n      \"budget\": 72000000,\n      \"director\": \"Mel Gibson\"\n    },\n    {\n      \"name\": \"Argo\",\n      \"year\": 2012,\n      \"budget\": 44500000,\n      \"director\": \"Ben Affleck\"\n    },\n    {\n      \"name\": \"A Quiet Place\",\n      \"year\": 2018,\n      \"budget\": 17000000,\n      \"director\": \"John Krasinski\"\n    },\n    {\n      \"name\": \"Dances with Wolves\",\n      \"year\": 1990,\n      \"budget\": 22000000,\n      \"director\": \"Kevin Costner\"\n    },\n    {\n      \"name\": \"Unforgiven\",\n      \"year\": 1992,\n      \"budget\": 14000000,\n      \"director\": \"Clint Eastwood\"\n    },\n    {\n      \"name\": \"The Postman\",\n      \"year\": 1997,\n      \"budget\": 80000000,\n      \"director\": \"Kevin Costner\"\n    }\n  ],\n  \"infer\": {\n    \"columns\": []\n  },\n  \"link\": {\n    \"ExactMatch\": null\n  }\n}")
  .asString();
This response does not have an example.

Before uploading data to a dataset you first need to create it! Please do so through API, or find your datasets through the UI.

​
Uploading structured data

Data can currently be uploaded by providing a structured JSON file. To upload data, you must have write permissions for the dataset. If it’s a dataset you created, you automatically have these permissions. However, if the dataset belongs to someone else, you’ll need to request write access.

While this functionality is supported, there is no user interface available for it at the moment. Until the UI is implemented, you can contact the DataLinks team to enable sharing permissions on the backend.

Authorizations

​
Authorization
string
header
required

Use a Bearer token for authentication. Submit the token using the Authorization header: Authorization: Bearer <token>. The token can be generated in Settings

Path Parameters

​
namespace
string
required

The namespace is the name you want to group your datasets around.

​
datasetName
string
required

Name of the dataset. The same name may exist in different namespaces, for example companies exists in both sanctions and in the company registry.

Body

application/json

Response

200

Successful ingestion response.