Data Hub
Watchers

List watcher config revisions

Requires scope `watchers:read`.

GET
/watchers/{watcherId}/config-revisions

Requires scope watchers:read.

Authorization

bearerAuth
AuthorizationBearer <token>

Personal access tokens begin with dhub_… and are restricted by their assigned scopes.

In: header

Path Parameters

watcherId*string
Formatuuid

Query Parameters

limit?integer
Range1 <= value <= 200

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/watchers/497f6eca-6276-4993-bfeb-53cbbbba6f08/config-revisions"
{  "data": [    {      "revision": 1,      "source": "web",      "status": "pending",      "status_reason": "string",      "settings": {        "watch_directory": "string",        "file_patterns": [          "string"        ],        "run_detection": {          "pattern": "string",          "recursive": true        },        "upload_mode": "auto",        "stability_period_seconds": 1,        "max_stability_wait_seconds": 1,        "upload_parallelism": 1      },      "created_at": "2019-08-24T14:15:22Z",      "resolved_at": "2019-08-24T14:15:22Z",      "created_by": {        "id": "string",        "name": "string",        "email": "string"      },      "created_by_token": {        "id": "string",        "name": "string"      }    }  ]}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

Check watcher update availability GET

Requires scope `watchers:read`. PAT only; browser sessions are rejected.

Change a watcher's config POST

Requires a token that lists `watchers:admin` explicitly; legacy tokens with `*` or `watchers:write` get 403. Browser sessions must belong to an admin. Stores a pending revision that the watcher applies after its next heartbeat. Returns 409 when `base_revision` isn't the latest revision (`details.reason: stale_revision`) or the watcher runs a version older than 1.4.0 (`details.reason: watcher_update_required`).