API Reference · Overview
Authentication
Every request to the Nyckel API must be authenticated with a JWT
access token sent in the Authorization header:
Authorization: Bearer <accessToken>
Access tokens are obtained by POSTing to the
https://www.nyckel.com/connect/token endpoint with your client_id
and client_secret. The same credentials are surfaced in two places
for convenience:
- The Access Management section of your Nyckel account.
- The Integrate tab of any Function.
Either location shows the same account-wide client_id and
client_secret.
curl -X POST \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id=<clientId>&client_secret=<clientSecret>' \
'https://www.nyckel.com/connect/token'
A successful response returns a bearer token valid for one hour:
{
"access_token": "<accessToken>",
"token_type": "Bearer",
"expires_in": 3600
}
Tokens expire after one hour; request a new one as needed to keep API
access uninterrupted. The connect/token endpoint lives outside the
/v1/ API surface and is not part of this reference.