Calven

Generate a token with an API key and client secret

POST

/v1/auth/token

auth

Generate a token with an API key and client secret via an OAuth client credentials grant.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

client_id

string

required

The APIKey ID for which a token is requested

client_secret

string

required

The api key secret

Example

{
    "client_id": "string",
    "client_secret": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.calven.com/v1/auth/token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "client_id": "string",
    "client_secret": "string"
}'

Responses

🟢200Success

application/json

Body

access_token

string

required

JWT token that can be used for making authorized subsequent requests

expires_in

number

required

Number of seconds before the token expires

Example:

3600

token_type

string

required

The type of token being returned

Example

{
    "access_token": "string",
    "expires_in": 3600,
    "token_type": "string"
}

🟠401Payload when auth header is missing or invalid

Generate a token with an API key and HMAC

Presence Overview