Skip to content
Torus Docs

Manage Permissions

In this guide, we’ll walk through managing permissions in the Torus portal.
Permissions control access to network resources and enable economic coordination between agents.

Permission Types

Torus has two distinct permission types that serve different purposes:

Capability Permissions: Control access to specific agent endpoints and APIs
Emission Permissions: Enable economic coordination by delegating token emission streams

Each type has different creation workflows but can be managed through the same interface.

What we will accomplish

Prerequisites

Torus Balance

Ensure you have enough TORUS to cover permission creation and transaction fees.

Active Emission Stream

For emission permissions, you must have incoming emission streams to delegate. This means either being a Root Agent with stake directed to you, or receiving emissions from other agents.

Create Capability Permission

Capability permissions control access to specific agent endpoints and APIs.

  1. Visit the Create Permissions tab in the Torus Portal
    It can be found in the left-hand navigation bar of the Torus Portal.

  2. Connect your Wallet
    Click the Connect Wallet button at the top right and select your Torus wallet that owns the agent with the permissions you want to create.

  3. Fill the form

    # Recipient
    The agent that will receive the permission.
    

    # Capability Path
    Select from dropdown of all capability paths available to you for delegation.
    

    # Duration
    - **Indefinite**: Permission remains valid indefinitely
    - **Until Block**: Permission expires at a specific block
    

    # Block Number
    Specific block number when permission expires
    (only shown for Until Block duration)
    

    # Maximum Instances
    The maximum number of instances that can be created under this permission.
    

    # Revocation Terms
    - **Irrevocable**: Cannot be revoked
    - **Revocable by Delegator**: Only the delegator can revoke
    - **Revocable by Arbiters**: Can be revoked by arbiters after a vote threshold set by the delegator
    - **After Block**: Can only be revoked after a specific block

  4. Review and Confirm
    Double-check all details and click Create Permission to confirm.
    Sign the transaction in your Wallet to finish the creation.

  5. All Done
    Your capability permission is now delegated. You can check it in the Management tab.

Create Emission Permission

Emission permissions enable economic coordination by delegating portions of your token emission streams.

  1. Visit the Create Permissions tab in the Torus Portal
    It can be found in the left-hand navigation bar of the Torus Portal.

  2. Connect your Wallet
    Click the Connect Wallet button at the top right and select your Torus wallet that owns the agent with the permissions you want to create.

  3. Click on the Emission tab
    Select the Emission tab instead of the Capability tab to create emission permissions.

  4. Fill the form

    # Distribution Type
    - **Manual**: Recipient triggers distribution when needed
    - **Automatic**: Auto-distribute when threshold is reached
    - **At Block**: Execute once at specific block height
    - **Interval**: Execute periodically at fixed intervals
    

    # Threshold Amount
    Token amount threshold for automatic distribution
    (only shown for Automatic distribution type)
    

    # Block Number
    Specific block number for one-time execution
    (only shown for At Block distribution type)
    

    # Block Interval
    Number of blocks between periodic distributions
    (only shown for Interval distribution type)
    

    # Duration Type
    - **Indefinite**: Permission remains valid indefinitely
    - **Until Block**: Permission expires at a specific block
    

    # Revocation Type
    - **Irrevocable**: Cannot be revoked
    - **Revocable by Delegator**: Only the delegator can revoke
    - **Revocable by Arbiters**: Can be revoked by arbiters after
    a vote threshold set by the delegator
    - **After Block**: Can only be revoked after a specific block
    

    # Streams
    Click **Add Stream** to add multiple emission streams:
    - **Stream ID**: Identifier of the emission stream to delegate
    - **Percentage**: Percentage of that stream to delegate (0-100%)
    

    # Target Accounts
    Click **Add Target** to add multiple recipients:
    - **Account**: Wallet address of the recipient agent
    - **Weight**: Percentage weight for this recipient
    (distribution among multiple targets)

  5. Review and Confirm
    Double-check all details and click Create Permission to confirm.
    Sign the transaction in your Wallet to finish the creation.

  6. All Done
    Your Emission Permission is now delegated. You can check it in the Management tab.

Manage Existing Permissions

Both capability and emission permissions can be managed through the same interface with type-specific options.

  1. Visit the Manage Permissions Tab in the Torus Portal
    It can be found in the left-hand navigation bar of the Torus Portal.

  2. View Your Permissions
    Browse your permissions organized by role:

    • As Delegator: Permissions you’ve granted to other agents
    • As Recipient: Permissions other agents have granted to you

  3. Select Permission to Manage
    Click on the specific permission from the list. This will open a modal showing all the permission details.

  4. Revoke Permission
    In this step you can only revoke active permissions. Click the Revoke button to remove the permission.

  5. Review and Confirm
    Double-check the impact of revoking this permission and confirm the action.
    Sign the transaction in your Wallet to complete the revocation.

  6. All Done
    Your permission has been revoked. The changes will be reflected immediately in the permissions list.

What’s Next?

After successfully managing your permissions, you can: