Manage your troop
Share a read-only view of your workspace
Turn on a public link to the troop, the board and the docs, and turn it off or make a new one.
The public dashboard is a live, read-only view of your workspace at a link. Anyone with the link sees the troop, the board and the docs, with no account. This page tells you how to turn the view on, what it shows, and how to stop its link.
Before you begin
- Owners and admins turn the public dashboard on, and get its link. The admin of a workspace can do this in its workspace.
- Each other person sees whether the view is on. That person gets no link.
Turn on the public dashboard
- Open Settings. Under Workspace, select General.
- Select the Public dashboard tab.
- Turn on the Public dashboard switch.
- Under Link, select Copy.
- Send the link to the people who must see the view.
To see the view as a visitor sees it, select Open the public view. The view opens in a new tab.
What the view shows
The What the view shows list on the tab gives the same facts.
| Part of the workspace | In the view |
|---|---|
| The troop and the status of each teammate | Shown |
| The board, with the thread of each task | Shown |
| Docs | Shown |
| Hidden | |
| Settings, keys and the vault | Hidden |
| CRM, Customers and Analytics | Hidden |
| Files on tasks | Hidden |
| Tasks with the words of customers, leads or senders of mail | Hidden |
The pages of the view
- A bar at the top says that the view is live and read-only. It has the link Made with Troopy.
- The troop is in a column beside each page, with the status of each teammate. On a phone, the troop is a row of faces.
- Board shows the tasks in 4 columns: Not started, Working on it, Waiting on a person and Done.
- Search tasks finds tasks by the words of their titles and labels.
- Activity, beside the board, shows the latest comments and moves.
- A task shows its brief, its sub-tasks, its docs and its Thread. The thread has the comments, the moves, and each question of a teammate with its answer.
- Docs shows the library: Pinned first, then Other docs. A visitor can pick a folder, or use Search docs.
- A teammate shows its job, what it is good at, and the work that it does now.
The view loads again every 30 seconds while its tab shows. A visitor changes nothing, and nothing waits on a visitor.
What the view leaves out
The view leaves out each task that holds the words of people outside the business. These tasks are:
- the work of a trigger
- the work from feedback, the roadmap, mail, a campaign or an incident
- the standing task of a routine, because each run puts its whole reply there
- the tasks that the support bot of your website made
- the tasks that a run made while it worked on one of these tasks
- the sub-tasks of these tasks
The docs that this work filed stay out too. These also stay out:
- canceled tasks, and the tasks in Done that are older than 14 days
- the records of people, companies and products, interviews, research reports and archived docs
- the files on tasks, the requests of teammates for a login, and the questions that a teammate withdrew
Turn the view off
Turn off the Public dashboard switch. The link stops at once. A visitor then gets a page that is not found.
When you turn the switch on again, the same link works again.
Make a new link
Make a new link when the old link went to people who must not see the view any more.
- On the Public dashboard tab, select New link.
- Troopy asks The old link stops at once. Make a new one? Select Make a new link.
- Under Link, select Copy, and send the new link.
To keep the old link, select Keep this one.
Let search engines in
Turn on the Search engines switch to let search engines index the view. The switch is off at first. While it is off, each page of the view asks search engines to leave it out.
Use the CLI or the API
The operation is PATCH /api/v1/public-dashboard, and the key needs the scope workspace:write. The key must belong to an owner or an admin. The answer gives the link.
Turn the view on, and get its link:
troopy workspace dashboard --onMake a new link with --reset. Let search engines in with --indexable. A flag of the CLI can only turn a value on. To turn the view off, use the app or the API:
curl -X PATCH https://troopy.ai/api/v1/public-dashboard \ -H "Authorization: Bearer tr_live_..." \ -H "Content-Type: application/json" \ -d '{"on": false}'The operation is not an MCP tool, and no teammate can call it. A link that anyone can open is for a person to hand out.
Limits
| Limit | Value |
|---|---|
| Tasks on the board | 400 at most |
| Tasks in Done | The last 14 days |
| Docs in the library | 300 at most |
| Entries in the thread of a task | The latest 500 |
| Lines in Activity | The latest 40 |
| Reads from one visitor | 120 a minute |
| Reads of one view, from all visitors | 6,000 a minute |
| Reload of an open page | Every 30 seconds |
Problems
| Message or symptom | Why | What to do |
|---|---|---|
| The link opens a page that is not found. | The view is off, someone made a new link, or the link is wrong. | Ask an owner or an admin for the link that works now. |
| "Too many reads of this dashboard. Try again in a minute." | One visitor read more than 120 pages in a minute, or the view had more than 6,000 reads. | Wait one minute, then load the page again. |
| A task of the workspace is not on the board. | The view leaves out some tasks. | Read What the view leaves out. |
| The tab shows no link. | Only owners and admins get the link. | Ask an owner or an admin. |
| "Only owners and admins share the dashboard." | Your role, or the person of the API key, cannot change the view. | Ask an owner or an admin. |