Watched Objects
Watching an object subscribes you to its change feed. Whenever someone modifies a watched object — edits a field, adds a relationship, attaches an extension, deprecates it — that change shows up on your Watched Objects page (and in your in-app notifications, if you have those enabled).
Why watch
Architecture inventories grow fast. You can’t track every object across every project, but you usually have a short list of objects you do care about: the application your team owns, the capability your roadmap centers on, the technology choice you’re betting on. Watching them is the cheapest way to stay in the loop without scrolling the global Audit Log.
Watching an object
Open any object’s detail page. The header has an Eye toggle button — click it to start watching. Click again to stop. The button reflects state (filled when watching, outlined when not).
Bulk-watching from the inventory list view works the same way: multi-select rows → Bulk → Watch selection.
The Watched Objects page
Open from the sidebar (Collaboration → Watched Objects with the Eye icon, or directly at /watched-objects).
The page is a paginated list (50 entries per page) of every object you currently watch, with these columns:
| Column | Notes |
|---|---|
| Name | The object’s display name. Sortable. Links to the object detail page. |
| Type | Humanized type label (e.g. “Application”, “Business Capability”). |
| Status | The object’s lifecycle status badge: draft, approved, deprecated, retired. |
| Actions | Quick-open icon → jumps to the object detail page in inventory. |
A search box at the top of the page filters the list locally by name or type. View toggle (table / cards) is on the standard FilterBar — same as Inventory and Search Page.
If you haven’t watched anything yet, the empty state shows the Eye icon with a prompt to flag your first object from inventory.
Pagination
Each page holds 50 entries. Use Previous / Next at the bottom; the page indicator reads “Page X of Y.” The page number doesn’t persist in the URL — refreshing returns you to page 1.
Notifications integration
Watching an object also enables in-app notifications for changes to it (toggle per-event in Settings → Notifications). The Watched Objects page is the catalog; notifications are the push channel. Unwatch an object to stop both at once.
API
For automation: GET /api/v1/watched-objects?page=1&limit=50 returns the same paginated list. POST /api/v1/objects/:id/watch and DELETE /api/v1/objects/:id/watch toggle watch state. See API Reference.
When to use
- Track applications you own as primary contact.
- Watch the capability your team is building toward.
- Keep an eye on a deprecated component until it’s fully retired.
- Stay aware of changes to objects in compliance scope (GDPR, DORA, SOX) without subscribing to the entire inventory.