Home  >  API & Developers


In order to interact with the DataKnowl API, your application must authenticate.

Authentication is based on two keys:

- AccessKeyID
- SecretAccessKey

To authenticate using these master keys, use HTTP Basic Auth (RFC 7617) with the username set to your AccessKeyID and the password set to your SecretAccessKey.

Your AccessKeyID and SecretAccessKey can be found on your Developers Dashboard.

The AccessKeyID is used to identify the user. SecretAccessKey is never sent or transmitted.

Authentication is implemented by passing parameters via HTTP headers

Parameters are:

Header Value Description
Authorization Authorization: Basic <credentials>
AccessKeyId Key used to identify the user
Timestamp The timestamp of the request
Signature The signature Empty for Basic Auth


curl -v -X POST -H "Content-type: application/x-www-form-urlencoded; charset=UTF-8"
                -H "AccessKeyId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 
                -H "Timestamp: 1571411606301" 
                -H "Signature: " 
                -u {AccessKeyId}:{SecretAccessKey}
                -d "sequence:text=Where is the nearest office ?" 

{VAGNT} is the V-Agent RID
{VACNV} is the Conversation RID, or NEW to start a new conversation

© 2020 Complexity Intelligence, LLC