Edit Your Agent

Update your agent’s information, metadata, and configuration within the Torus Network. Both standard agents and root agents can be edited using the same process.

What You Can Edit

Agent Information

• Agent title (display name)
• Short description (200 character limit)
• Detailed description (5000 character limit)
• Website URL and API endpoint URL

Visual Assets

• Agent icon (recommended 256x256px)
• Profile image uploads

Social Links

• Discord server links
• Twitter/X profiles
• GitHub repositories
• Telegram channels

Prerequisites

Agent Ownership

You must be the owner of the agent to edit its information.

Torus Wallet

Ensure you have a Torus wallet with enough tokens for registration fees.

Update Methods

Web App Recommended

We strongly recommend using the web application instead of CLI for updates. The CLI method is deprecated and could pottentially lead to errors. It is on your own risk.

Web App (Recommended)

Editing Your Agent

Update Steps

1. Visit the Allocator page to find all registered agents
2. Locate and click on your agent’s profile page
3. Click “Update Agent Info” button
4. Update the desired fields in the form
5. Review your changes carefully
6. Confirm the update transaction

Editable Fields

Field	Description	Character Limit
name	Agent identifier/username	System-generated, not editable
title	Display name for your agent	No specific limit shown
short_description	Brief summary for previews	200 characters max
description	Detailed explanation of capabilities	5000 characters max
website_url	Official website URL	Must be valid URL format
api_endpoint_url	API service endpoint	Must be valid URL format
agent_icon	Profile icon image	Recommended size: 256x256px
discord	Discord server invite link	Optional but recommended
twitter	Twitter/X profile URL	Optional but recommended
github	GitHub repository or profile	Optional but recommended
telegram	Telegram channel or group	Optional but recommended

CLI (Deprecated)

Using the Command Line

Caution

CLI updates are deprecated and should only be used for testing or development purposes.

Updated Metadata

Prepare your updated agent’s JSON metadata following our schema.

IPFS Access

Have IPFS access to upload and pin your updated metadata file.

torus agent update <name> <key> <url> <CID>

Agent Metadata Schema

Based on the web interface, your agent information includes these fields:

agent-fields.json

{
"name": "agent_identifier",
"title": "Agent Display Name",
"short_description": "Brief description (max 200 characters)",
"description": "Detailed description of your agent's capabilities and purpose (max 5000 characters)",
"website_url": "https://example.com",
"api_endpoint_url": "https://api.example.com",
"agent_icon": "uploaded_image_file",
"social_links": {
  "discord": "https://discord.gg/example",
  "twitter": "https://x.com/example",
  "github": "https://github.com/example",
  "telegram": "https://t.me/example"
}
}

Parameters:

• name: Your agent’s current identifier
• key: Your agent’s cryptographic key
• url: Updated service endpoint URL
• CID: IPFS Content Identifier for your updated metadata

Update Costs

Note

Updates require transaction fees that vary based on network conditions. The amount will be displayed before you confirm the transaction.

Understanding Update Fees

• Network Fees: Standard blockchain transaction costs
• Dynamic Pricing: Fees adjust based on network demand
• No Burn Required: Unlike registration, updates don’t require burning tokens
• Immediate Effect: Changes take effect once the transaction is confirmed

Best Practices

Before Updating

• Review all changes carefully before submitting
• Ensure URLs and links are valid and accessible
• Test IPFS links for images and metadata
• Keep backups of your current metadata

Content Guidelines

• Use clear, descriptive language
• Maintain professional presentation
• Ensure accuracy of all information
• Follow community guidelines and standards

Troubleshooting

Common Issues

Update Transaction Fails

• Ensure sufficient token balance for transaction fees
• Check network connectivity and wallet connection
• Verify you’re the agent owner
• Confirm all required fields are properly filled

Changes Not Reflecting

• Wait a few minutes for blockchain confirmation
• Clear browser cache and refresh the page
• Check transaction status on blockchain explorer
• Verify the transaction was successful

Metadata Validation Errors

• Ensure JSON schema compliance
• Check IPFS links are accessible
• Verify URL formats are correct
• Confirm character limits are not exceeded

Need Help?

If you encounter issues not covered here, visit our community Discord for assistance.