> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptoprocessing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Change a user role

export const RoleCard = ({title, byRequestOnly = false, children}) => {
  return <div className="flex items-stretch rounded-2xl bg-white dark:bg-[rgb(var(--background-dark))] border border-gray-950/10 dark:border-white/10 overflow-hidden mb-2.5">

      <div className="w-44 min-w-[11rem] flex flex-col justify-center items-start gap-2 p-5 border-r border-gray-950/10 dark:border-white/10">
        <span className="text-base font-semibold">
          {title}
        </span>
        {byRequestOnly && <Badge color="blue">By request only</Badge>}
      </div>

      <div className="flex-1 p-5 prose dark:prose-invert max-w-none">
        {children}
      </div>

    </div>;
};

export function Available({to, except}) {
  const roles = <Tooltip tip="Roles determine what each user can see and do in the portal." cta="See role descriptions" href="/merchant-administration/add-a-user#determine-which-role-to-use">roles</Tooltip>;
  if (to) {
    return <><strong>Available to {roles}:</strong> {to.map(role => <>{" "}<Badge color="blue">{role}</Badge></>)}</>;
  } else {
    return <><strong>Available to all {roles} except</strong> {except.map(role => <>{" "}<Badge color="blue">{role}</Badge></>)}</>;
  }
}

<Available to={["Owner"]} />

Update a user’s account access when their responsibilities change. This page explains how to choose the right role, change an existing user’s role, and request **Owner** access when needed.

## Determine which role to use

User roles define what each user can see and do in the portal.

<Note>Roles marked **By request only** cannot be assigned directly from the portal. Contact your account manager to assign them.</Note>

<RoleCard title="View">
  For users who need read access to account activity, with a limited set of transactional actions.

  <Expandable title="permissions">
    * View account balance, account information, fees, cold addresses, transactions, payments, invoices, payment requests, mass payouts, withdrawal and operation limits, team members, and contacts
    * Manage deposit addresses
    * Resend transaction callbacks
    * Create payment requests and invoices
    * Resend refund emails
  </Expandable>
</RoleCard>

<RoleCard title="Exchange">
  For users who need to convert funds between currency balances.

  <Expandable title="permissions">
    * All **View** permissions
    * Exchange funds
  </Expandable>
</RoleCard>

<RoleCard title="Limits">
  For users who configure withdrawal thresholds and cold wallet transfer rules.

  <Expandable title="permissions">
    * All **View** permissions
    * Manage keep-on-hot limits
    * Manage the minimum transaction amount for automatic transfers to cold wallets
  </Expandable>
</RoleCard>

<RoleCard title="Submitter" byRequestOnly>
  For users who initiate crypto withdrawals and payouts but should not be able to approve them.

  <Expandable title="permissions">
    <Warning>For the **Submitter** role to function as intended, withdrawal limits must be configured. If no limits are configured, or if a withdrawal amount does not exceed the configured limit, withdrawals created by a **Submitter** will be processed immediately without requiring approval.</Warning>

    * All **View** permissions
    * Create crypto withdrawals
    * Create mass payouts
  </Expandable>
</RoleCard>

<RoleCard title="Approver" byRequestOnly>
  For users who approve withdrawals but should not be able to initiate them.

  <Expandable title="permissions">
    * All **View** permissions
    * Approve or decline withdrawals that require manual approval
  </Expandable>
</RoleCard>

<RoleCard title="Accountant">
  For users who manage fiat operations and bank accounts.

  <Expandable title="permissions">
    * All **View** permissions
    * Create fiat withdrawals
    * Create fiat top-ups
    * View and add bank accounts
  </Expandable>
</RoleCard>

<RoleCard title="Accounts Payable" byRequestOnly>
  For users who manage both crypto and fiat operations.

  <Expandable title="permissions">
    <Warning>For the **Accounts Payable** role to function as intended, withdrawal limits must be configured. If no limits are configured, or if a withdrawal amount does not exceed the configured limit, withdrawals created by an **Accounts Payable** user will be processed immediately without requiring approval.</Warning>

    * All **View** permissions
    * Create fiat withdrawals
    * Create fiat top-ups
    * View and add bank accounts
    * Create crypto withdrawals
    * Create mass payouts
    * Manage payment refunds
    * Exchange funds
  </Expandable>
</RoleCard>

<RoleCard title="Owner" byRequestOnly>
  Full access to the merchant account and all portal sections.

  <Expandable title="permissions">
    * Includes permissions from all other roles
    * Add and remove users, and update user roles
    * Manage API keys and allowed IP addresses
    * Configure callback URL, callback options, and callback parameters
    * Configure withdrawal limits
    * Configure balance amount notifications and notifications for pending withdrawal approvals
    * Disable withdrawals
    * Manage cold addresses
    * Manage active currencies (shown on the **Balances** tab)
    * Configure underpayment handling for payment requests
    * Configure payment currencies for payment requests
  </Expandable>
</RoleCard>

<RoleCard title="Restricted">
  No access to the portal. Can contact the Support team and create tickets.
</RoleCard>

## Change a user role

<Steps>
  <Step>
    In your portal, go to the **Team** tab.
  </Step>

  <Step>
    Click the pencil icon next to the user you want to remove.
  </Step>

  <Step>
    Select a new role for the user.
  </Step>

  <Step>
    Enter your 2FA code and click **Save**.
  </Step>
</Steps>

## FAQ

### How do I assign the Owner, Submitter, Approver, or Accounts Payable role to a user?

Only your account manager can assign the **Owner**, **Submitter**, **Approver**, and **Accounts Payable** roles. To assign one of these roles, contact your account manager.

### How do I change the role of a user with the Owner role?

To change the role of an **Owner** user, contact your account manager.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.