Skip to main content
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:
MethodPOST
Hosthttps://api.talview.com
Route/api/rest/auth_user_login
Content typeapplication/json
Request payload definition:
AttributeData TypeMandatoryDescription
usernameStringYesAPI username that will be shared by Talview
passwordStringYesAPI password that will be shared by Talview
tenant_idIntegerYesTenant identifier for each of the organization on Talview, will be shared by Talview
Sample request payload: 
{
  "username": "[email protected]",
  "password": "secure_password",
  "tenant_id": 1
}
Sample response payload:
  1. 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:>"
    }
  }
}
  2. 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": "[email protected]",
  "password": "secure_password",
  "tenant_id": 1
}'