Skip to main content

Managing sites

This guide covers the Sites list in the USDN portal, opening a site detail page, updating site information, and deleting a site.

Sites list​

Open Sites from the main navigation. You see every site your organization can access, with toolbar controls for:

  • Search — filter by text across site fields.
  • Filter by type — limit to a site type (for example cloud vs branch).
  • Clear filters — reset search and type when filters are active.
  • List / grid view — switch how rows are displayed.
  • Column picker (list view) — choose which columns are visible.
  • Create New Site — opens the site creation flow.

Sites list and toolbar

The table shows columns such as name, type, device count, location, and dates depending on your column settings. Click a row (or a card in grid view) to open that site’s detail page—not only the site name cell.

Site detail page​

The detail page shows:

  • Summary in the left column: map (when coordinates exist), location string, description, contact email/phone, type, created/updated timestamps.
  • Edit Site and Delete Site actions at the bottom of that column.
  • Tabs on the right: Devices, Network (segments), and Location (larger map when coordinates exist).

Site detail overview

Update a site​

  1. Open the site from the Sites list.
  2. Click Edit Site in the left column.
  3. In the Edit Site dialog, change the fields you need (same general field set as creation: type, name, address or cloud region, contacts, and so on).
  4. Click Update Site to save, or Cancel to close without saving.

Edit Site dialog

Changes apply immediately after a successful save; the detail view refreshes from the server.

Delete a site​

Deleting a site is permanent for that site record and is intended only when the location is fully decommissioned from USDN. You can delete a site only after none of its devices is active (see below).

  1. Open the site from the Sites list.
  2. Click Delete Site in the left column (red text button).
  3. Read the confirmation: you must acknowledge that the action cannot be undone.
  4. Click Delete to confirm, or Cancel to keep the site.

Delete Site confirmation

A site with active devices cannot be deleted​

USDN refuses to delete a site while any of its devices is still active. Otherwise the site's routers would keep running the tunnels, DHCP, NGFW rules and Snort engine they were given, with nothing left in the portal to manage or remove them.

When a site still has active devices, the delete fails and the site is kept. Through the API, DELETE /v1/sites/{id}/ returns 409 Conflict with a message that names each active device by hostname and serial number. An offline device still counts as active: it keeps its configuration and applies it again when it reconnects.

Before you delete the site, move each listed device to another site or have it decommissioned. The portal does not offer either step for a registered device, so ask USDN support (see Support & Escalation). Once no device at the site is active, the site deletes as before.

The same rule applies to deleting an organization: it is refused while any of its sites has an active device.

caution

There is also an Actions (⋯) menu on each list row with menu items such as Edit and Delete. Those shortcuts only run when the list is wired to handlers in your deployment; the supported path for edit and delete in the current portal is the site detail page as described above.

Need help?​

See Support & Escalation.