Manage users

Use this section to add/update/view new users in evalink talos.

Introduction

There are two types of users in evalink talos:

• Administrator

• Operator

evalink talos offers the ability to invite new users in your company and select their type (Administrator/Operator). They can then accept the invitation and create an account with their e-mail and password.

Managing users is currently restricted for generated API tokens

invite users

POST https://talos-app.io/api/oauth-service/invitations

Use this endpoint to invite users into your evalink talos tenant.

Headers

Name	Type	Description
Authorization	string	Use 'Bearer' followed by your API token.

Request Body

Name	Type	Description
email	string	The e-mail of the user you would like to invite.
companyId	string	The Company ID, as it is displayed on the evalink talos Web Interface.
companyAdmin	boolean	The admin priviledges for the user you are inviting.

200

{
  "links": {
    "empty": true
  }
}

Example:

{
  "companyAdmin": true,
  "companyId": "<companyId>",
  "email": "<emailAddress>"
}

find users by company ID

GET https://talos-app.io/api/oauth-service/users/search/findByCompanyId:companyId

Use this endpoint to find the users for a particular company.

Path Parameters

Name	Type	Description
companyId	string	The Company ID, as it is displayed on the evalink talos Web Interface.

Headers

Name	Type	Description
Authorization	string	Use 'Bearer' followed by your API token.

200

{
  "_embedded": {
    "users": [
      {
        "email": "string",
        "firstName": "string",
        "id": "string",
        "lastName": "string",
        "mfaEnabled": true
      }
    ]
  },
  "_links": {}
}

find a list of users by user IDs

GET https://talps-app.io/api/oauth-service/users/search/findByIdIn

Use this endpoint to receive a list of users based on a collection of user IDs.

Path Parameters

Name	Type	Description
ids	array	The collection of user IDs.

Headers

Name	Type	Description
Authorization	string	Use 'Bearer' followed by your API token.

200

{
  "_embedded": {
    "users": [
      {
        "email": "string",
        "firstName": "string",
        "id": "string",
        "lastName": "string",
        "mfaEnabled": true
      }
    ]
  },
  "_links": {}
}

find a user by user ID

GET https://talos-app.io/api/oauth-service/users/{id}

Use this endpoint to receive a user by their user ID.

Path Parameters

Name	Type	Description
id	string	The required user ID.

Headers

Name	Type	Description
Authorization	string	Use 'Bearer' followed by your API token.

200

{
  "email": "string",
  "firstName": "string",
  "id": "string",
  "lastName": "string",
  "links": {
    "empty": true
  },
  "mfaEnabled": true
}

{
  "email": "string",
  "firstName": "string",
  "id": "string",
  "lastName": "string",
  "links": {
    "empty": true
  },
  "mfaEnabled": true
}

find the roles of a particular user

GET https://talos-app.io/api/oauth-service/users/{id}/roles

Use this endpoint to receive the roles of a particular user by using the user ID.

Path Parameters

Name	Type	Description
id	string	The required user ID.

Headers

Name	Type	Description
Authorization	string	Use 'Bearer' followed by your API token.

200

{
  "_embedded": {
    "persistentEntityResources": [
      null
    ]
  },
  "_links": {}
}

update the roles of a particular user

POST https://talos-app.io/api/oauth-service/users/{id}/roles

IUse this endpoint tot updates the role of a specific user.

Path Parameters

Name	Type	Description
id	string	The required user ID.
userRoleIds	array	The collection of user role ID.

Headers

Name	Type	Description
Authorization	string	Use 'Bearer' followed by your API token.

200

{
  "_embedded": {
    "persistentEntityResources": [
      null
    ]
  },
  "_links": {}
}