v1

latestOpenAPI 3.1.02026-07-24153164.0 KB

user-back-office-pam-role-controller

Assign Role to Consumer

Assigns one or more roles to an existing user (consumer) within your organization on the TECS Platform.

Pre-requisites:

The consumer initiating the role assignment must have an owner role or a superior role.
For example, to assign the BO_USERMANAGEMENT_REGISTER_USER role, the caller must possess the BO_USERMANAGEMENT_SUPERUSER role.

Authentication: Supports both Basic authentication (using Base64 encoded credentials) and Bearer token authentication.

post/assignRoles

Headers

Authorizationstring required

Authorization header. Use either: - Bearer token (e.g., "Bearer <token>") - Basic authentication (e.g., "Basic <Base64 encoded credentials>")

Request body

consumerUUIDstring required

Unique identifier of the consumer (user) to whom the role(s) will be assigned.

Example request

{
  "consumerUUID": "user-12345",
  "roles": [
    {
      "corporateUUID": "4dbbab90-74f5-4d8d-92e1-d02e6a4a0dee",
      "userRoleName": "MP_CORPORATE"
    }
  ]
}

Response

Role assignment successful.

responseCodeinteger

Response code: 0 indicates success; any non-zero value indicates an error.

responseMessagestring

A human-readable message providing additional details about the outcome.

Example response

{
  "responseMessage": "OK"
}