v1

latestOpenAPI 3.1.02026-08-0413468163.9 KB

v1-internal

Deep Reset Connector Route

Admin-only: dispatch a per-source-DB connector deep reset (ARD-1273).

Rebuilds ONE source DB's pgstream pipeline (delete pgstream -> wipe its branch target schemas -> redeploy -> validate) without disturbing the connector's other source DBs. Returns 202 with an operation_id; the caller polls GET /v1/operations/{id}. The destructive work runs on the DBOS byoc queue, not on this request-serving pod.

Refuses with 400 when source_db is unknown (not a deployed, selected database). Coalescing is connector-scoped: the operation resource_id is the connector id and the requested source_db is stored in result. A second deep reset of the same source DB reuses the in-flight operation; a different source DB on the same connector returns 409 because connector status and engine_config are connector-level state.

post/v1/internal/connectors/{connector_id}/deep-reset

Path parameters

connector_idstring required

Query parameters

source_dbstring required

Response

Successful Response

{"stackTrail":"paths:/v1/internal/connectors/{connector_id}/deep-reset:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}