---
title: "Deep Reset Connector Route"
method: POST
path: "/v1/internal/connectors/{connector_id}/deep-reset"
tags: ["v1-internal"]
---

# Deep Reset Connector Route

`POST /v1/internal/connectors/{connector_id}/deep-reset`

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.

## Path parameters

- `connector_id` string, required

## Query parameters

- `source_db` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tryardent/apis/fastapi.md) · [All operations](https://skmtc.dev/tryardent/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryardent/fastapi/revisions/885763e37dfb/schema)