> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Regulatory Sources

> Register and manage monitored regulator URLs, with per-source detail showing polling status and detected change events.

The Regulatory Sources page lists watched regulator URLs and allows administrators to register, edit, pause, and delete source monitors. It is located at route `/gr/compliance/regulatory-sources`.

## Overview

The page is rendered by `RegulatorySourcesPage`. It fetches sources via `useRegulatorySourceList` with an optional search filter. Users with `GR_PERMISSIONS.REGULATORY_SOURCE_ADMIN` (`gr.compliance.regulatory_source.admin`) see a **Register source** button and per-row action menus (edit, pause/resume, delete). Pause/resume is handled by `useToggleRegulatorySource`; deletion by `useDeleteRegulatorySource`. Each row links to the Source Detail page. The route is protected by `GR_PERMISSIONS.REGULATORY_CHANGE_VIEW` (`gr.compliance.regulatory_change.view`).

## Who it's for

Requires permission: `gr.compliance.regulatory_change.view`

Admin actions (register, edit, pause, delete) additionally require: `gr.compliance.regulatory_source.admin`

## Before you start

* You need `gr.compliance.regulatory_change.view` to access this page.
* Registering or modifying sources requires the admin permission above.
* Changes detected from sources are visible on the Regulatory Changes page.

## Managing sources

1. Go to **Governance & Compliance → Compliance → Regulatory Sources** at `/gr/compliance/regulatory-sources`.
2. Use the search bar to find an existing source.
3. Select a row to open the Source Detail page.
4. To register a new source, select **Register source** and complete the form dialog.
5. To pause a source, open its action menu and select pause.
6. To delete a source, open its action menu and select delete (confirm in the dialog).

| Concept      | Description                                                             |
| ------------ | ----------------------------------------------------------------------- |
| Source       | A registered URL that the system polls for regulatory content changes   |
| Status       | Active vs. paused — paused sources are not polled                       |
| `last_error` | An error flag shown on the Source Detail page when the last poll failed |

## Viewing a source

The Source Details page (`/gr/compliance/regulatory-sources/:id`) shows the full record for a single regulatory source, including its polling status, last error (if any), and detected change events.

The page is rendered by `RegulatorySourceDetailPage`. It loads the source record via `useRegulatorySource` and associated change events via `useRegulatoryChangeEvents` filtered by `source_id`. The dynamic breadcrumb label is set to `source.name`. If the source has a `last_error` flag, an alert is displayed. The route is protected by `GR_PERMISSIONS.REGULATORY_CHANGE_VIEW`.

Displayed fields include: name, URL, status badge, last error (if any), and a list of detected change events for this source.

Before you start: navigate from the Regulatory Sources list at `/gr/compliance/regulatory-sources`. A source record must exist for the given ID.

1. Go to **Governance & Compliance → Compliance → Regulatory Sources** and select a source.
2. Review the source name, URL, and status.
3. If an error alert is displayed, review the error and take corrective action (SME to confirm required steps).
4. Scroll to the detected changes list to see change events attributed to this source.
5. Select a change event to open the Regulatory Changes page or change detail.

## Related

<Columns cols={2}>
  <Card title="Governance & Compliance" icon="scale-balanced" href="/gr/overview">
    Governance & Compliance core overview.
  </Card>

  <Card title="Governance & parity" icon="clipboard-check" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/gr.tsx
  * src/cores/gr/pages/RegulatorySourcesPage.tsx
  * src/cores/gr/pages/RegulatorySourceDetailPage.tsx
  * src/cores/gr/hooks/useRegulatorySources.ts
  * src/cores/gr/hooks/useRegulatoryChangeEvents.ts
  * src/platform/permissions/constants.ts
</Accordion>