---
title: "Create or update a regulatory source watch"
method: POST
path: "/api/v1/regulatory-monitoring/source-watches"
tags: ["Regulatory Monitoring API"]
---

# Create or update a regulatory source watch

`POST /api/v1/regulatory-monitoring/source-watches`

## Request

- Base URL: `https://api.esheria.ai`
- URL: `https://api.esheria.ai/api/v1/regulatory-monitoring/source-watches`
- Auth: API key in header `x-api-key`

## Headers

- `idempotency-key` string, required

## Request body

- SourceWatchCreateRequest
  - `domain_pack_id` string, required
  - `source_asset_id` string
  - `source_uri` string, required
  - `source_kind` 'binding' | 'guidance' | 'watchlist' | 'context'
  - `authority_type` 'binding' | 'non_binding' | 'watchlist' | 'context'
  - `expected_hash_sha256` string
  - `expected_etag` string
  - `expected_last_modified` string
  - `check_interval_seconds` integer
  - `status` 'active' | 'paused' | 'retired'
  - `metadata` object

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Unauthorized
- `402`: Credits exhausted
- `409`: Conflict
- `422`: Validation error
- `503`: Billing or dependency unavailable

---

[API](https://skmtc.dev/esheria/apis/esheria-regulatory-api.md) · [All operations](https://skmtc.dev/esheria/apis/esheria-regulatory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/esheria/apis/esheria-regulatory-api/revisions/33e5de529f65?raw)