post
https://api.blockpeer.finance/api/blockpeer-trade/trade/registry/roles/add
Assign an organization-level access role to an address for a specific Token Registry. These roles control who within the End User organisation can perform actions such as issuing, accepting, or restoring electronic trade documents (eBL / ETRs).
What these roles are (important)
The following roles are access control roles, not document lifecycle roles:
| Role | Purpose |
|---|---|
| Admin | Manages registry configuration and roles |
| Minter | Allowed to issue (mint) new ETRs (eBL / ePN) |
| Accepter | Allowed to accept incoming ETR transfers |
| Restorer | Allowed to restore or return ETRs to issuer |
These roles define who is authorized to perform actions within the End User organisation.
How this fits in the Trade flow
- Called by the Integrating System
- Used after Token Registry deployment and DNS validation
- Grants organisational permissions to specific addresses
- 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
- The Integrating System redirects the End User to
redirectUrl - The End User reviews the role assignment
- The End User approves the action using passkeys
- The role is assigned to the specified address
- The Integrating System stores the updated role configuration
Without End User approval, the role is not assigned.
📌 Responsibility clarification
- Roles belong to the End User organization
- BlockPeer does not store organizational role mappings
- The Integrating System must store:
- Registry address
- Addresses assigned to each role
- Role configuration per organization
BlockPeer acts only as TradeTrust infrastructure.
Important notes
- Each role assignment is a separate approved action
- Network transaction fees apply (paid by the End User-controlled account)
- Role changes affect who can issue or manage ETRs
Common use cases
- Assign Admin role to a compliance or ops lead
- Assign Minter role to a shipping or trade operations team
- Assign Accepter role to a receiving or finance team
- Assign Restorer role for exception handling and returns