Merchant

Update user roles in merchant

Update the roles assigned to a user in a specific merchant. Requires MERCHANT_SETTINGS_ASSIGN_ROLE_TO_USER permission.

put/api/v1/organizations/{organizationId}/merchants/{merchantId}/users

Request

  • Base URL: https://api-sandbox.koywe.com
  • URL: https://api-sandbox.koywe.com/api/v1/organizations/{organizationId}/merchants/{merchantId}/users
  • Auth: HTTP bearer

Path parameters

organizationIdstring required
Example:org_abc123

Organization identifier

merchantIdstring required
Example:mrc_def456

Merchant identifier

Request body

userIdstring required

User ID

rolesIdsstring[] required

Array of role IDs to assign to the user

Example request

{
  "userId": "k3u_abc123",
  "rolesIds": [
    "k3r_operator"
  ]
}

Response

User roles updated successfully

successboolean required

Whether the operation was successful

messagestring

Optional message providing more details about the operation

Example response

{
  "success": true,
  "message": "User roles updated successfully"
}

Changes

No recorded changes to this operation across all 1 revision of this API.