Datasets

Our Datasets endpoint can be used to programmatically import data either as a new dataset, or appended to an existing one.

Get Dataset(s)

GET https://api.akkio.com/v1/datasets

Get all datasets in your organization, or optionally get a specific dataset

Query Parameters

Name
Type
Description

id

string

(Optional): If dataset ID is included, only the specific dataset is returned

api_key*

string

Your api key, accessible from https://app.akkio.com/team-settings

{
    "status": "success",
    "datasets": [
        {
            "id": "7pmPB4MXU390Bs0Axxnd",
            "name": "Telco-Customer-Churn.csv"
        },
        {
            "id": "83BxRLqOADMfgEPTZI7v",
            "name": "Historic Conversions.csv"
        },
        {
            "id": "9eEQ4Rp92y9Z6Cws4Sot",
            "name": "titanic-sheet-titanic"
        }
    ]
}
# Example cURL to list all datasets

 curl 'https://api.akkio.com/v1/datasets?api_key=api_key_string' 
#Example cURL to list detailed information about one dataset

curl 'https://api.akkio.com/v1/datasets?api_key=api_key_string&id=id_string' 

Create Dataset

POST https://api.akkio.com/v1/datasets

Creates a dataset with a given name

Request Body

Name
Type
Description

name*

string

The name of the dataset to be created

api_key*

string

Your API key, accessible from https://app.akkio.com/team-settings

{
    "status": "success",
    "dataset_id": "YOUR_DATASET_ID",
    "dataset_name": "YOUR_DATASET_NAME"
}
# Example cURL to create a new empty dataset

curl --request POST 'https://api.akkio.com/v1/datasets?name=name_string&api_key=api_key_string'

Add Rows To Dataset

POST https://api.akkio.com/v1/datasets

Request Body

Name
Type
Description

rows

array

List of rows in form [{'field name 1': 'value 1', 'field name 2': 0}, {...}, ...]

id

string

The ID of the dataset to add rows to

api_key *

string

Your API key, accessible from https://app.akkio.com/team-settings

{
    "status": "success"
}
# Example cURL 1 - passing in via form body, entirely command-line (no character limit)
curl -g --request POST --location 'https://api.akkio.com/v1/datasets?id=id_string&api_key=api_key_string' \
-H "Content-Type: application/json" \
-d '{"rows":"[{\"field name 1\": \"value 1\", \"field name 2\": \"value 2\"}]"}'
# Example cURL 2 - passing in via form body & file named data.json (no character limit)
curl -g --request POST --location 'https://api.akkio.com/v1/datasets?id=id_string&api_key=api_key_string' \
-H "Content-Type: application/json" \
-d @data.json

Delete Dataset

DELETE https://api.akkio.com/v1/datasets

Deletes a given dataset from a given ID

Request Body

Name
Type
Description

api_key*

string

Your API key, accessible from https://app.akkio.com/team-settings

id

string

The ID of the dataset

{
    "status": "success"
}
# Example cURL

curl --request DELETE 'https://api.akkio.com/v1/datasets?id=id_string&api_key=api_key_string'

Last updated

Was this helpful?