Standard Talview Authentication

Every API request to Talview needs to be authenticated by passing the access_token received with the response of the below-mentioned login API. Request header definition:

Method	POST
Host	https://api.talview.com
Route	/api/rest/auth_user_login
Content type	application/json

Request payload definition:

Attribute	Data Type	Mandatory	Description
username	String	Yes	API username that will be shared by Talview
password	String	Yes	API password that will be shared by Talview
tenant_id	Integer	Yes	Tenant identifier for each of the organization on Talview, will be shared by Talview

Sample request payload:

{
  "username": "username@talview.com",
  "password": "secure_password",
  "tenant_id": 1
}

Sample response payload:

Success response: HTTP status code - 201

{
  "auth_user_login": {
    "success": true,
    "error_message": null,
    "data": {
      "access_token": "<:jwt_token:>",
      "expires_in": 1715077045,
      "refresh_token": "<:refresh_token:>"
    }
  }
}

Error Response: HTTP status code - 401

{
  "error": "Wrong username/password"
}

Sample CURL request:

curl --request POST \\
  --url https://supergraph.talview.com/api/rest/auth_user_login \\
  --data '{  
  "username": "username@talview.com",
  "password": "secure_password",
  "tenant_id": 1
}'