▶️API Authentication

The first step to integrate with Unitary's API is setting up authentication. Unitary's API provides an authentication endpoint which uses your API key to generate a Bearer token that must be included in any subsequent API requests you wish to make.

The endpoint reference below gives more detail about how to use the authentication endpoint, how to use the returned Bearer token, and the expiration of tokens.

This API Authentication guide assumes you have your API key already set up. If this is not the case, please email at [email protected].

Endpoint reference

Authenticate with API Key to obtain an API token

post

Clients wishing to interact with the Unitary API must first authenticate by calling this endpoint with a valid API Key in the request body.

The resulting api_token should be used in subsequent API requests by including a header with the format:

Authorization: Bearer {api_token}

The api_token will be valid for a period of time (default 24 hours) and should be used for all subsequent API requests until it expires, or is invalidated.

This endpoint is rate-limited and may return error codes if too many authentication requests are submitted within a short time frame. For this reason clients should avoid re-authenticating too often.

Body
keystring · passwordWrite-onlyRequired
Responses
200
Successful Response
application/json
post
POST /authenticate HTTP/1.1
Host: 
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 18

"key='password'"
{
  "api_token": "text",
  "expiry": "2025-06-30T11:05:29.077Z"
}

Example code

curl --location --request POST 'https://api.unitary.ai/v1/authenticate'
--header 'Content-Type: application/x-www-form-urlencoded'
--data-urlencode 'key={API_KEY}' 

Last updated

Was this helpful?