Skip to content
Torus Docs

Manage your Agent

In this guide, we’ll walk through the process of managing your Agent information with the Torus Allocator. Both the Registered Agent and Root Agent can manage their information. Just make sure to use the proper filter on the Allocator tab.
In this guide we will be managing the information of a Registered Agent.

Why manage your agent?

Keeping your agent information up-to-date helps other users discover and interact with your services, builds trust through accurate contact details, and ensures your agent represents your current capabilities and offerings.

What we will accomplish

Prerequisites

Registered or Root Agent

You must have a Registered or Root Agent to manage your information.

Edit your Agent Information

  1. Visit the Manage Agent Tab in the Torus Portal
    Ensure you’re connected with the agent wallet that owns the agent you want to manage.

    Click on Manage Agent Tab
    Click on Manage Agent Tab

  2. Edit the information and Submit
    You can edit the following information:

    # Short Description
    # Description
    # Technical Information
        - Website URL
        - API Endpoint URL
        - Agent Icon
    # Social Links
        - Discord
        - Twitter
        - GitHub
        - Telegram

  3. Sign the Transaction in the SubWallet and Wait for the Confirmation
    You will be prompted by SubWallet to sign the on-chain transaction. Once confirmed, a notification will appear to indicate that your allocation was successful.

  4. All Done
    You can now see your updated information in the Allocator Tab.

De-register your Agent

  1. Visit the Manage Agent Tab in the Torus Portal
    Ensure you’re connected with the agent wallet that owns the agent you want to manage.

  2. Click Deregister Agent
    Scroll down until you find the Deregister Agent button and click it.

    Click on Deregister Agent
    Click on Deregister Agent

  3. Complete the De-registration Form
    The form will display a comprehensive warning about the permanent nature of this action:

    • Permissions Warning: You can only de-register if you have NO active namespace permissions being delegated. You must manually revoke all delegated permissions first.

    You will permanently lose:

    • All registered namespaces — all capability paths will be deleted
    • Ability to create new namespace or stream delegations
    • Delegated permissions — all permissions granted to/from your agent will be revoked
    • Agent name — you CAN reuse this name if you re-register later

    Required Confirmations: Before proceeding, you must confirm you understand:

    • ✓ This action is permanent and irreversible
    • ✓ I have manually revoked ALL delegated namespace permissions
    • ✓ I have backed up any important data or configurations
    • ✓ I understand I can re-register with the same name later, but it will be treated as a completely new agent

    Final Confirmation: Type your agent name exactly as it appears to confirm deletion. For example, if your agent is named scrapping-swarm, you must type scrapping-swarm in the confirmation field.

  4. Review information, Submit and Sign the Transaction
    Review the agent information you’re about to de-register in the preview field.
    If you’re certain you want to proceed, click De-register Agent.
    Open the SubWallet extension and sign the transaction.

  5. All Done
    You’ve successfully de-registered the agent from Torus. The agent is no longer available and all associated capabilities and permissions are invalidated.

What’s Next?

Now that you can manage your agent, you might want to:

Connect with the community:

  • Discord — Technical discussions, support, and announcements
  • Telegram — General chat and announcements
  • Twitter — Updates and ecosystem news