---
title: "Assign Role to Consumer"
method: POST
path: "/assignRoles"
tags: ["user-back-office-pam-role-controller"]
---

# Assign Role to Consumer

`POST /assignRoles`

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.

## Headers

- `Authorization` string, required

## Request body

- InputAssignRoles
  - `consumerUUID` string, required — Unique identifier of the consumer (user) to whom the role(s) will be assigned.
  - `roles` UserRole[], required — List of roles to assign to the consumer.
    - `corporateUUID` string, required — Unique identifier of the corporate entity associated with the role.
    - `userRoleName` 'TE_MERCHANT_TERMINAL_MANAGEMENT' | 'BO_TE_TRANSACTION_HISTORY' | 'BO_TRANSACTIONMANAGEMENT_CANCEL' | 'BO_TRANSACTIONMANAGEMENT_REFUND' | 'BO_TRANSACTIONMANAGEMENT_EMV' | 'BO_TRANSACTIONMANAGEMENT_ECR' | 'SERVICE_BLACKLISTCHECK' | 'MP_CORPORATE' | 'BO_USERMANAGEMENT_MANDATOR_MANAGER' | 'BO_TRANSACTIONMANAGEMENT_COMPLETION' | 'BO_TRANSACTIONMANAGEMENT_PAYMENT' | 'MCOM_WEBAPP_TX_HISTORY' | 'BO_USERMANAGEMENT_UPDATE_CORPORATE' | 'BO_MP_CREATE_NEW_PRODUCT' | 'SYSTEM_GET_TERMINAL_ID' | 'BO_DAILY_REPORTS_VIEW' | 'DAILY_REPORTS_VIEW' | 'BO_DAILY_REPORTS_CUSTOM' | 'DAILY_REPORTS_CUSTOM' | 'TW_GET_ECOM_PARAMETERS' | 'TE_KEEP_ALIVE_LIST' | 'BO_TRANSACTIONMANAGEMENT_ECOM' | 'BO_MP_UPDATE_XML_TEMPLATE' | 'BO_MP_GET_XML_TEMPLATE' | 'BO_MANDATOR_CLEARING_EXPORT' | 'SYSTEM_REGISTER_MERCHANT_TERMINAL' | 'BO_MP_MOVE_TID', required — The name of the role to assign.

## Response `200`

Role assignment successful.

- OutputAssignRoles
  - `responseCode` integer — Response code: 0 indicates success; any non-zero value indicates an error.
  - `responseMessage` string — A human-readable message providing additional details about the outcome.

---

[API](https://skmtc.dev/bluefin-com/apis/merchant-services.md) · [All operations](https://skmtc.dev/bluefin-com/apis/merchant-services/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluefin-com/merchant-services/revisions/84e973bef72c/schema)