API Overview

6min
The Hunni API gives you complete control over your Assets. You can:
Folders: Retrieve, Create, Modify, and Delete Folders 
Tables: Retrieve, Create, Modify, and Delete Tables Details and Table Data
Views: Retrieve View Details and Data
Columns: Retrieve Columns and Column Types
Rows: Retrieve, Create, Modify, and Delete Rows
Other: Get Asset Types, Subscription Details, and API Version Numbers
The first step to using the API is authentication, which is explained below. Then feel free to explore our API Code Examples﻿ and Reference Docs.
API Credentials
You can obtain your API credentials from the Account menu located at the bottom of the left hand navigation.  Organization admins can enable API access for user accounts under the Manage Users menu, then clicking the gear icon on the users row and choosing Enabled from the API Access dropdown. 
﻿
Users that have API Access can retrieve and reset their API credentials from the bottom of the My Profile menu in Account
﻿
API Authentication
Hunni API supports the Client Credentials grant OAuth 2.0 authentication method.
To generate an API token, you will need to generate a Client ID and Client Secret for the account accessing the API. This can be done in the Manage Users menu for Business subscribers and My Profile for Individual subscribers.
Use the following token endpoint to authenticate with the Hunni API.
Token Endpoint
https://api.hunni.io/oauth/token
Free accounts do not have API access
Obtaining an access token
Request an access token using the token endpoint with the following parameters.
Send client credentials in the request body.
Name
Type
Description
grant_type
String
Value is client_credentials
client_id
String
The client id of the account
client_secret
String
The client secret of the account
Token Response
If the request for an access token is succesful, the authorization server will return an access token string, which can then be used in your API call.
﻿
Sample C# Token Request Code:
Note: The C# example below requires the Newtonsoft.Json library
C#
string strToken = null;
string strClientId = "ABCDEFGHIJKLMNOP";
string strClientSecret = "1234567890";

using (HttpClient client = new HttpClient())
{
    var requestToken = new HttpRequestMessage
    {
        Method = HttpMethod.Post,
        RequestUri = new Uri("https://api.hunni.io/oauth/token"),
        Content = new StringContent("grant_type=client_credentials&client_id=" + strClientId + "&client_secret=" + strClientSecret)
    };

    using (HttpResponseMessage response = client.SendAsync(requestToken).Result)
    {
        using (HttpContent content = response.Content)
        {
            var json = content.ReadAsStringAsync().Result;
            var result = JsonConvert.DeserializeObject<dynamic>(json);
            if (result["error_description"] == null)
            {
                strToken = result.access_token;
            }
        }
    }
}
string strToken = null;
string strClientId = "ABCDEFGHIJKLMNOP";
string strClientSecret = "1234567890";

using (HttpClient client = new HttpClient())
{
    var requestToken = new HttpRequestMessage
    {
        Method = HttpMethod.Post,
        RequestUri = new Uri("https://api.hunni.io/oauth/token"),
        Content = new StringContent("grant_type=client_credentials&client_id=" + strClientId + "&client_secret=" + strClientSecret)
    };

    using (HttpResponseMessage response = client.SendAsync(requestToken).Result)
    {
        using (HttpContent content = response.Content)
        {
            var json = content.ReadAsStringAsync().Result;
            var result = JsonConvert.DeserializeObject<dynamic>(json);
            if (result["error_description"] == null)
            {
                strToken = result.access_token;
            }
        }
    }
}
﻿
﻿
Name	Type	Description
grant_type	String	Value is client_credentials
client_id	String	The client id of the account
client_secret	String	The client secret of the account
Updated 21 Jan 2025
Did this page help you?
Account Management
API Code Examples