Authentication API

Authenticate with Telmai

This API authenticates user credentials and returns an access token

POST /auth/token

Parameters

Name	Type	Description
clientId	string	Client identifier for the application
grantType	string	Type of authentication. Use "password" or "refresh_token".
username	string	Username for the user
password	string	Password for the user. Required if grant_type is "password"
refreshToken	string	Refresh token string. Required if grant_type is "refresh_token"
code	string	Authorization code (used for authorization_code grant type)
redirectUrl	string	URL to redirect to after authorization
transactionId	string	Unique ID for tracking the request
tenant	string	Identifier for the tenant

Headers

Name	Type	Description
Content-type*	string	application/x-www-form-urlencoded

curl

curl -X 'POST' 'https://dev.telm.ai/api/auth/auth/token?clientId=string&grantType=password&username=string&password=string&refreshToken=string&code=string&redirectUri=string&transactionId=string&tenant=string' -H 'accept: */*' -d ''

200

{
  "expires": 3600,
  "access_token": "string",
  "refresh_token": "string",
  "token_type": "string"
}

401

{"description": "Unauthorized"}

403

{"description": "Forbidden"}

404

{"description": "Not Found"}