Generate an API token
Personal access tokens authenticate AI clients on your behalf.
- Sign in to app.umtri.io.
- Open the sidebar settings (gear icon) → API Tokens.
- Enter a label (e.g.
claude-desktop), pick a scope, click Generate token. - Copy the raw
umtri_pat_…immediately. It is shown only once.
Which scope?
| Scope | Can do | When to pick |
|---|---|---|
read | List grounds, read the graph & impact, list bugs, seasons, and history | Default. Safe for any client. |
write | Everything above + all write tools (create/update/delete, plan loop) | Only when you trust the client to mutate your ground. |
Lost the token? It cannot be recovered — only the SHA-256 hash is stored. Revoke it from the same page and generate a new one.