Agent Sharing and Access
Share agents with team members, create public chat links, organize with tags and system views, and manage on the go with Mobile Admin.
Team Sharing
Share agents with team members via email. Shared users get access to interact with the agent but cannot modify its configuration.
Open the agent detail page and click the Sharing tab (visible to the owner only).
Enter the email address of the person you want to share with.
Click Share. The email is automatically added to the platform whitelist.
The shared user can now see and interact with the agent (chat, tasks, view files).
Access Levels
| Level | Permissions |
|---|---|
| Owner | Full control — create, delete, configure, share, manage credentials and schedules. |
| Shared | Interact only — chat, run tasks, view files and logs. Cannot modify config, credentials, or permissions. |
| Admin | Full access to all agents regardless of ownership. |
All API endpoints check ownership or sharing status before granting access. Shared users see only their own chat messages. Admins see all messages. Deleting an agent cascades to remove all associated sharing records.
Sharing API
| Endpoint | Method | Description |
|---|---|---|
| /api/agents/{name}/share | POST | Share agent with an email address |
| /api/agents/{name}/share/{email} | DELETE | Remove a share |
| /api/agents/{name}/shares | GET | List all shares for an agent |
Public Links
Shareable URLs that let unauthenticated users chat with agents. Supports optional email verification, session persistence, per-user memory, and rate limiting.
Key Features
How It Works
Open the agent detail page and go to the Sharing tab.
Click Create Public Link.
Configure: email verification on/off, rate limits, custom welcome message.
Copy the generated URL and share it with recipients.
Recipients open the URL and start chatting immediately. Conversations persist — users can return later and continue.
Public Link API
| Endpoint | Method | Description |
|---|---|---|
| /api/agents/{name}/public-links | GET/POST | List or create public links |
| /api/agents/{name}/public-links/{id} | PUT/DELETE | Update or delete a public link |
| /api/public/chat/{token} | POST | Send a message via public chat |
| /api/public/history/{token} | GET | Retrieve chat history |
Tags and Organization
Organize agents with tags, saved system views, and tag clouds for visual grouping on the Dashboard.
Tag agents from the agent detail page, or programmatically via API/MCP.
Tags appear as colored badges on agent tiles throughout the UI.
The Dashboard shows tag clouds — agents grouped visually by tag.
On the Agents page, filter by tags. Filters persist across navigation.
Create System Views to save filter combinations (tags plus other criteria) for quick access.
Tag Management
• Add or remove individual tags from any agent.
• Replace all tags at once with a bulk set operation.
• Tags are shared across the platform — any tag applied to one agent is available for others.
Tag API
| Endpoint | Method | Description |
|---|---|---|
| /api/tags | GET | List all tags |
| /api/agents/{name}/tags | GET/POST/PUT | Get, add, or replace tags |
| /api/agents/{name}/tags/{tag} | DELETE | Remove a tag |
| /api/system-views | GET/POST | List or create system views |
Mobile Admin
Standalone mobile-optimized PWA at /m for managing agents on the go.
Navigate to http://localhost/m on a mobile device (or any browser).
Install as a PWA via Add to Home Screen for a native app experience.
The interface has three tabs:
• Agents — List agents, tap to chat, toggle autonomy, send tasks.
• Ops — View and act on operating room queue items.
• System — System-level controls and status.
Designed for quick interactions: check agent status, respond to agent questions, toggle autonomy on or off. Mobile Admin uses the same backend API as the desktop UI — no additional endpoints required.