Authorization Token

All requests are authorized via a OAuth2 bearer token. Requests for an access token should be made with client_credentials grant type. Bearer token will expire after 30 minutes, and will need to be refreshed. Expiration times will be returned with the token request, and represented in seconds from the time the token was issued.

Account

An API user needs to be create by Creovai Support, please send an email to support@creovai.com and they will walk you through the process of setting up an API user.  The API user client secret is only valid for 365 days, at which time a new secret will need to be generated. Creovai support team will reach out to the technical contact on file prior to the secret expiring to remind you that it must be cycled.

Example token request

POST https://[INSTANCE NAME].audio.tethr.com/Token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: 124
Expect: 100-continue
Connection: Keep-Alive

grant_type=client_credentials&client_secret=[ApiUserSecret]&client_id=[ApiUsername]

Sample token request using cURL

curl -k -X POST "https://[INSTANCE NAME].audio.tethr.com/Token" -dclient_id=[ApiUsername] -dclient_secret=[ApiUserSecret] -dgrant_type=client_credentials

Response (if the token request is successful)

{
    "access_token": "[TOKEN]",
    "token_type": "bearer",
    "expires_in": 1799
}