---
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`

## Request

- Base URL: `https://api.tryardent.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tryardent.com/v1/internal/connectors/{connector_id}/deep-reset`
- Auth: none declared

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/tryardent-api.md) - [All operations](https://skmtc.dev/tryardent/apis/tryardent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tryardent/apis/tryardent-api/revisions/a0512915b997?raw)