---
title: ui operations
---

The exact fields each `ui.*` operation takes and returns.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

Every op is `POST /v1/<op>` over HTTP and the MCP tool `loom_<op>`. The identity fields (`org`, `namespace`, `agent`, `user_id`, `session_id`) are filled from the token and the MCP session when a transport can; for an HTTP call with no token on a single-user server, the install's org on every op but `code.*` and `tracker.*` (which keep their plane's), and on [some ops](/ko/reference/http-api#request) its namespace and agent; see [identities and namespaces](/ko/concepts/identities-and-namespaces). The [operations index](/ko/reference/operations) explains role, kind and the MCP `all` listing. Unknown input fields are served and named in `ignored_args`.

<!-- prettier-ignore-start -->

## `ui.vitals`

Record one dashboard page's web vitals; the per-op ledger row the transport writes carries the fields.

`POST /v1/ui.vitals` · MCP `loom_ui_vitals` · role `viewer` · idempotent · not listed under the MCP `all` toolset

| Input field | Type | Default | Meaning |
| --- | --- | --- | --- |
| `org` | `str` | required | The tenant (first element of the identity tuple). |
| `namespace` | `str` | required | The namespace the op reads or writes. |
| `agent` | `str` | `'loom-ui'` | The writing or reading agent; `'-'` or `'*'` means any agent where the op allows it. |
| `route` | `str` | required | The dashboard route id (`memories`, `knowledge`, `admin/usage`...). |
| `lcp_ms` | `int \| None` | `None` | Largest contentful paint of the first view of the session, ms; None on a client-side navigation (the browser reports LCP once per document). |
| `long_task_ms` | `int` | `0` | Main-thread long tasks (>50 ms) summed over the view, ms. |
| `inp_ms` | `int \| None` | `None` | The longest interaction of the view (an event-timing entry's duration — input delay + processing + presentation), ms; None when none reached the client's threshold. |
| `dom_nodes` | `int` | `0` | Elements in the document when the view was flushed (the count of `*`). |
| `api_calls` | `int` | `0` | /v1 calls the view issued and the span from the first request's start to the last response's end, ms. |
| `api_ms` | `int` | `0` | A view held open for an hour of polls spans more than 600 s. |
| `build` | `str` | `''` | The server build the bundle was served by (health's build_commit). |
| `cold` | `bool` | `True` | True for the first view of the session (a document load), False for a navigation inside the SPA. |

| Output field | Type | Meaning |
| --- | --- | --- |
| `recorded` | `bool` | Always true: the vitals ride the ledger row the transport writes for the call. |
| `route` | `str` | The route id the call reported (echoes the request). |

<!-- prettier-ignore-end -->
