Remove Role From Token Registry

Remove an organization-level access role from an address for a specific Token Registry. Use this to revoke permissions such as the ability to issue (mint), accept, restore ETRs, or administer registry configuration.

How this fits in the Trade flow

  • Called by the Integrating System
  • Used when the End User organization needs to revoke access
  • Updates registry RBAC configuration
  • Requires explicit End User approval
  • Approval happens only via redirect URL and End User passkeys

Role changes affect organizational control and therefore require End User approval.

What happens next

  1. The Integrating System redirects the End User to redirectUrl
  2. The End User reviews the role removal request
  3. The End User approves the action using passkeys
  4. The role is removed from the specified address
  5. The Integrating System updates its stored role configuration

Without End User approval, the role is not removed.


Responsibility clarification

  • RBAC configuration belongs to the End User organization
  • BlockPeer does not store organizational role mappings
  • The Integrating System must store:
    • Registry address
    • Current role-to-address mappings
    • Any internal permission model derived from these roles

BlockPeer acts purely as TradeTrust infrastructure.


Important notes

  • Network transaction fees apply (paid by the End User-controlled account)
  • Removing a role may block certain actions (e.g., issuance) immediately
  • Consider using Get Role Status after approval to reconcile state

Common use cases

  • Offboarding a user from the issuance team (remove MINTER)
  • Revoking operational acceptance permissions (remove ACCEPTER)
  • Restricting exception handling permissions (remove RESTORER)
  • Tightening admin access (remove ADMIN)
Body Params

Role removal request payload

string
required
string
required
string
required
string
enum
required
Defaults to ADMIN

Select the role

Allowed:
string
enum
required
Defaults to STABILITY

Select the blockchain network

Headers
string

Unique key to ensure idempotency for API requests.

string

Unique external ID for tracking purposes, can be used for debugging and analytics.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json