diff --git a/docs/swarm/ui.md b/docs/swarm/ui.md index fe33f3cc..e4f96b36 100644 --- a/docs/swarm/ui.md +++ b/docs/swarm/ui.md @@ -23,7 +23,23 @@ An agent created here or with `swarmctl agent create` starts `paused`; set it Each agent on `/agents` opens three dialogs that write a credential for it into the swarm secret store through swarm-controller. All three are blind -set/update actions: no route lists linked accounts or hands a token back. +set/update actions: no route hands a token back. + +The agent's detail panel lists its linked accounts under **accounts**, one row +per account: kind, name and host. The table view's matrix column lists the +matrix rows. Both come from +`GET /api/hives/{hive}/agents/{agent}/linked-accounts`, which returns names +and hosts and never a credential. + +| kind | one row per | name | host | +| ------- | ------------------------------------------- | ----------- | ------------------------ | +| matrix | `swarm/agents//matrix/` | the account | its `homeserver`, if set | +| forgejo | `swarm/agents//forge/